NdisIMGetBindingContext 함수(ndis.h)

  • 아티클

NdisIMGetBindingContext 함수를 사용하면 NDIS 프로토콜 드라이버가 상위 수준 프로토콜 드라이버가 바인딩된 가상 미니포트에 대해 기본 중간 드라이버에서 만든 디바이스 컨텍스트 영역에 액세스할 수 있습니다.

구문

NDIS_HANDLE NdisIMGetBindingContext(
  [in] NDIS_HANDLE NdisBindingHandle
);

매개 변수

[in] NdisBindingHandle

호출자가 바인딩된 다음 하위 중간 드라이버의 가상 미니포트를 식별하는 NdisBindingHandle 매개 변수에서 NdisOpenAdapterEx 함수가 반환한 바인딩 핸들입니다.

반환 값

NdisIMGetBindingContext 는 지정된 가상 미니포트의 디바이스 컨텍스트 영역에 대한 핸들을 반환하거나 이러한 컨텍스트 영역이 없는 경우 NULL 을 반환합니다.

설명

프로토콜 드라이버 또는 중간 드라이버는 ProtocolBindAdapterEx 함수에서 NdisIMGetBindingContext를 호출하여 바인딩된 가상 미니포트에 대한 디바이스 컨텍스트에 액세스할 수 있습니다. 디바이스 컨텍스트는 동일한 기본 중간 드라이버에 바인딩된 모든 지나치게 많은 프로토콜 드라이버에 대한 공통 컨텍스트 영역을 제공합니다.

이러한 디바이스 컨텍스트 영역은 하위 수준 NDIS 중간 드라이버에 의해 할당되고 정의되었으며 에 대한 호출에서 NDIS에 전달되었습니다. NdisIMInitializeDeviceInstanceEx 함수입니다.

NdisIMGetBindingContext를 호출하는 모든 프로토콜 드라이버는 기본 중간 드라이버가 비페이지 풀에서 컨텍스트 영역을 할당했다고 안전하게 가정할 수 있습니다. 반환된 컨텍스트 영역을 읽기 전용으로 처리하여 이를 정의한 기본 NDIS 중간 드라이버가 설정한 상태를 유지해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisIMGetBindingContext(NDIS 5.1) 참조)에 대해 지원됩니다. Windows XP의 NDIS 5.1 드라이버(NdisIMGetBindingContext(NDIS 5.1) 참조)에 대해 지원됩니다.
대상 플랫폼 데스크톱
머리글 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL < DISPATCH_LEVEL
DDI 규정 준수 규칙 Irql_IM_Function(ndis)

추가 정보

NdisIMInitializeDeviceInstanceEx

NdisOpenAdapterEx

ProtocolBindAdapterEx