NdisIMGetDeviceContext

NDIS_HANDLE NdisIMGetDeviceContext( IN NDIS_HANDLE MiniportAdapterHandle );

NdisIMGetDeviceContext 함수는 ProtocolBindAdapter 함수에 의해 할당된 장치 컨텍스트 영역을 접근하도록 NDIS 인터미디엇 드라이버의 MiniportInitialize 함수를 허락한다.

매개변수

MiniportAdapterHandle

MiniportInitiailize 함수에 대한 입력 핸들을 지정한다.

리턴값

NdisIMGetDeviceContext 함수는 MiniportAdapterHandle에 의해 지정된 가상 NIC을 위한 장치 컨텍스트 영역에 대한 접근을 리턴하거나 혹은 만약 드라이버의 ProtocolBindAdapter 함수는 그러한 장치 컨텍스트 영역을 할당하지 않는다면은 NULL을 리턴한다.

주석

NDIS 인터미디엇 드라이버의 MiniportInitialize 함수는 초기화시에 가상 NIC을 위한 장치 컨텍스트 영역을 접근하기 위해 NdisIMGetDeviceContext 함수를 호출한다. 항상 그러한 영역을 위해 메모리는 드라이버의 MinipotInitialize 함수가 호출되도록 하는 이러한 영역에 대한 포인터로 NdisIMInitializeDeviceInstaceEx 함수를 호출하는 인터미디엇 드라이버의 ProtocolBindAdapter 함수에 의해 제공된다. 그러나, 인터미디엇 드라이버는 그러한 컨텍스트 영역을 가질 필요는 없다.

NdisIMGetDeviceContext 함수로부터 리턴하자마자, MiniportInitialize 함수는 인터미디엇 드라이버 개발자가 가상 NIC과 바인드한 상위 레벨 프로토콜들의 정보들로 가상 NIC을 위한 드라이버 정의 상태를 설정한다.

같은 가상 NIC에 바인드된 상위 레벨 NDIS 프로토콜들은 ProtocolBindAdapter 함수들로부터 NdisIMGetBindindContext 함수를 호출함으로써 이러한 장치 컨텍스트 영역을 접근할 수 있다.

NdisIMGetDeviceContext 함수의 호출자들은 IRQL <= DISPATCH_LEVEL 를 실행할 수 있다. 일반적으로, NDIS는 IRQL PASSIVE_LEVEL로 MiniportInitialize 함수들을 호출한다.