OPEN_NDK_ADAPTER_HANDLER 콜백 함수(ndisndk.h)

아티클
02/29/2024

OpenNDKAdapterHandler(OPEN_NDK_ADAPTER_HANDLER) 함수는 NDK 지원 NDIS 미니포트 어댑터에서 NDK 어댑터 instance 엽니다.

구문

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

NDIS_STATUS OpenNdkAdapterHandler(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNDIS_OPEN_NDK_ADAPTER_PARAMETERS Parameters,
       NDK_ADAPTER **ppNdkAdapter
)
{...}

매개 변수

[in] MiniportAdapterContext

MiniportInitializeEx 함수에 미니포트 드라이버가 할당한 컨텍스트 영역에 대한 핸들입니다. 미니포트 드라이버는 이 컨텍스트 영역을 사용하여 NDIS 미니포트 어댑터에 대한 상태 정보를 유지 관리합니다.

[in] Parameters

NDK_ADAPTER instance 여는 입력 매개 변수를 정의하는 NDIS_OPEN_NDK_ADAPTER_PARAMETERS 구조체에 대한 포인터입니다.

NDIS_OPEN_NDK_ADAPTER_PARAMETERS 구조는 NDKPI 주 버전과 NDK 소비자가 지원할 수 있는 가장 낮은 NDKPI 부 버전을 지정해야 합니다.

공급자가 소비자가 지정한 주 버전을 지원하지 않는 경우 공급자는 NDIS_STATUS_BAD_VERSION 요청을 실패해야 합니다.

공급자가 소비자 지정 주 버전을 지원하고 지정된 부 버전이 공급자가 지원하는 가장 높은 부 버전보다 작거나 같은 경우 공급자는 요청을 성공시키고 공급자가 지원하는 가장 높은 부 버전을 사용해야 합니다.

예를 들어 소비자가 버전 1.0을 요청하고 공급자가 1.1을 지원하는 경우 공급자는 NDK_ADAPTER_INFO 구조체 및 NDK 개체 헤더에서 버전 1.1을 보고해야 합니다.

참고 공급자의 상위 부 버전은 항상 하위 부 버전(즉, 상위 집합)과 완전히 호환됩니다.

공급자가 소비자 지정 주 버전을 지원하고 지정된 부 버전이 공급자가 지원하는 가장 높은 부 버전보다 큰 경우 공급자는 NDIS_STATUS_BAD_VERSION 요청을 실패해야 합니다.

ppNdkAdapter

NDK_ADAPTER 구조체에 대한 포인터를 보유하는 변수에 대한 포인터입니다. OPEN_NDK_ADAPTER_HANDLER 반환될 때 ppNdkAdapter에서 참조하는 NDK_ADAPTER 구조체는 새로 연 NDK 어댑터 instance 식별합니다.

반환 값

OPEN_NDK_ADAPTER_HANDLER 다음 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
NDIS_STATUS_SUCCESS	NDK 어댑터 instance 성공적으로 열렸습니다.
NDIS_STATUS_BAD_VERSION	요청된 버전 번호는 지원되지 않습니다.
NDIS_STATUS_ADAPTER_NOT_READY	미니포트 어댑터의 NDK 기능을 사용할 수 없습니다.
NDIS_STATUS_RESOURCES	리소스가 부족하여 NDIS에서 NDK 어댑터를 열 수 없습니다.

설명

OPEN_NDK_ADAPTER_HANDLER NDK 지원 NDIS 미니포트 어댑터에서 NDK_ADAPTER instance 엽니다. 동일한 NDIS 미니포트 어댑터에 여러 NDK_ADAPTER 인스턴스를 만들 수 있습니다. 각 NDK_ADAPTER instance NDK 애플리케이션 프로그래밍 인터페이스를 구현하는 디스패치 함수 테이블에 대한 포인터를 포함합니다. 미니포트 드라이버는 CLOSE_NDK_ADAPTER_HANDLER 함수를 호출하여 NDK 어댑터 instance 닫고 연결된 리소스를 해제합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되지 않음, NDIS 6.30 이상에서 지원됨
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	Windows
헤더	ndisndk.h
IRQL	PASSIVE_LEVEL