NdisIMGetBindingContext

NDIS_HANDLE NdisIMGetBindingContext( IN NDIS_HANDLE NdisBindingHandle );

NdisIMGetBindingContext함수는 상위 레벨 프로토콜이 바인딩된 가상 닉에대해 NDIS프로토콜로하여금 하위 인터미디엇 드라이버에의해 만들어진 장치 컨텍스트영역에 접근하도록 허용한다.

매개변수

NdisBindingHandle

호출자가 바인딩된 다음 하위 인터미디엇 드라이버의 가상 닉을 확인하는 NdisOpenAdapter함수에의해 리턴되는 핸들을 지정한다.

리턴값

NdisIMGetBindingContext함수는 주어진 가상 닉에대한 장치 컨텍스트 영역의 접근을 리턴하거나 혹은 마냑 그런 컨텍스트가 없다면 NULL을 리턴한다.

주석

최상위 레벨 NDIS프로토콜 드라이버 혹은 인터미디엇 프로토콜은 바인딩된 가상 닉에대한 장치 컨텍스트에 접근하기위해 ProtocolBindAdapter함수로부터 NdisIMGetBindingContext함수를 호출할수 있다. 장치 컨텍스트는 같은 하위 인터미디엇 드라이버와 바인딩된 모든 상위 레벨 프로토콜들에대해 공통적인 컨텍스트 영역을 제공한다.

그런 장치 컨텍스트 영역은 하위 레벨 NDIS인터미디엇 드라이버에의해 할당되고 정의되고 NdisIMInitializeDeviceInstanceEx함수의 호출로 NDIS에게 전해진다. 만약 인터미디엇 드라이버의 ProtocolBindAdapter함수에의해 할당되었다면, 이 인터미디엇 드라이버의 MiniportInitialize함수는 이 장치 컨텍스트 영역의 접근을 얻기위해 NdisIMGetDeviceContext함수를 호출한다.

NdisIMGetBindingContext함수를 호출하는 모든 프로토콜들은 하위 인터미디엇 드라이버가 비페이지화되는 POOL로부터 컨텍스영역을 할당했다는것을 거의 가정할수 있다. 그들은 리턴된 컨텍스트영역을 읽기전용으로 다루어야하고, 그것을 정의하는 하위 NDIS인터미디엇 드라이버에의해 설정된 상태를 유지한다.

NdisIMGetBindingContext함수의 호출자는 IRQL < DISPATCH_LEVEL에서 동작되어야만 한다.