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) |