NdisGetDriverHandle

VOID NdisGetDriverHandle( IN PNDIS_HANDLE NdisBindingHandle, OUT PNDIS_HANDLE NdisDriverHandle );

NdisGetDriverHandle함수는 호출자 제공 핸들에의해 가리켜지는 아답터 포트를 소유하고 있는 닉 미니포트 드라이버에대한 핸들을 생성한다.

매개변수

NdisBindingHandle

닉 미니포트 드라이버에대한 핸들이 생성되는것에대한 바인딩된 아답터에대한 핸들의 포인터. 일반적으로 NdisGetDriverHandle함수는 NdisOpenAdapter함수에의해 리턴된다.

NdisDriverHandle

호출자 할당 변수의 포인터. 만약 호출이 성공이면, NdisGetDriverHandle함수는 이 호출자 할당 변수내에 닉 미니포트 드라이버에대한 핸들을 리턴한다. 이 미니포트 드라이버는 NdisBindingHandle에의해 지정된 바인딩된 아답터의 포트를 익스포트 한다.

주석

아답터 포트는 NdisBindingHandle바인딩내에 보여진다. 프로토콜 드라이버는 이 아답터의 포트를 소유하고 있는 닉 미니포트 드라이버에대한 핸들을 생성하기위해 NdisGetDriverHandle함수를 사용한다. 프로토콜 드라이버는 주어진 바인딩에대해 닉 미니포트 드라이버를 확인하는것 이상의 목적에대해 닉 미니포트 드라이버에대한 핸들을 사용할수 없다.

프로토콜 드라이버는 같은 미니포트에의해 익스포트된 아답터 포트들에대한 모든 바인딩에대해 NdisDriverHandle에 닉 미니포트 드라이버에대한 같은 핸들을 생성한다. 프로토콜 드라이버는 일반적으로 프로토콜에의해 열려진 두 바인딩된 아답터 포트가 같은 미니포트에의해 소유되었는지를 체크하기위해 NdisGetDriverHandle함수를 사용한다.

닉 미니포트 드라이버와 관련된 모든 아답터 포트에 FFP상태를 비우기위해 프로토콜 드라이버는 닉 미니포트에게 OID_FFP_FLUSH요청을 보낸다.

NdisGetDriverHandle함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작한다.