Share via

NdisIMGetDeviceContext 함수(ndis.h)

  • 아티클

참고 NDIS 5. x 는 더 이상 사용되지 않으며 NDIS 6으로 대체됩니다. x. 새로운 NDIS 드라이버 개발은 Windows Vista로 시작하는 네트워크 드라이버를 참조하세요. NDIS 5 포팅에 대한 자세한 내용입니다. x 드라이버를 NDIS 6으로. x, NDIS 5.x 드라이버를 NDIS 6.0으로 포팅을 참조하세요.

이 함수를 사용하면 NDIS 중간 드라이버의 MiniportInitialize 함수가 ProtocolBindAdapter 함수에 의해 할당된 디바이스 컨텍스트 영역에 액세스할 수 있습니다.

구문

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

매개 변수

[in] MiniportAdapterHandle

MiniportInitialize에 대한 핸들 입력을 지정합니다.

반환 값

다음 표에는 이 함수의 반환 값이 나와 있습니다.

값 Description
NDISIMGETDEVICECONTEXT MiniportAdapterHandle로 식별된 가상 NIC의 디바이스 컨텍스트 영역에 대한 액세스를 반환합니다.
NULL 드라이버의 ProtocolBindAdapter 함수가 이러한 디바이스 컨텍스트 영역을 할당하지 않은 경우

설명

NDIS 중간 드라이버의 MiniportInitialize 함수는 NdisIMGetDeviceContext 를 호출하여 초기화 중인 가상 NIC의 디바이스 컨텍스트 영역에 액세스합니다. 일반적으로 이러한 영역에 대한 메모리는 이 영역에 대한 포인터를 사용하여 NdisIMInitializeDeviceInstanceEx를 호출하는 중간 드라이버의 ProtocolBindAdapter 함수에 의해 제공되므로 드라이버의 MiniportInitialize 함수가 호출됩니다. 그러나 중간 드라이버에는 이러한 컨텍스트 영역이 필요하지 않습니다.

NdisIMGetDeviceContext에서 반환되는 경우 MiniportInitialize는 중간 드라이버 작성기가 가상 NIC에 이후에 자신을 바인딩하는 상위 수준 프로토콜에 유용하게 사용할 정보를 사용하여 가상 NIC에 대한 드라이버 정의 상태를 설정합니다.

동일한 가상 NIC에 바인딩된 상위 수준 NDIS 프로토콜은 이후 ProtocolBindAdapter 함수에서 NdisIMGetBindingContext를 호출하여 이 디바이스 컨텍스트 영역에 액세스할 수 있습니다.

OS 버전: .NET 4.0 이상을 Windows CE.

요구 사항

요구 사항 값
헤더 ndis.h
라이브러리 Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

추가 정보