NdisFGetOptionalSwitchHandlers 함수(ndis.h)

  • 아티클

Hyper-V 확장 가능 스위치 확장은 NdisFGetOptionalSwitchHandlers 함수를 호출하여 Hyper-V 확장 가능 스위치 처리기 함수에 대한 포인터 목록을 가져옵니다.

구문

NDIS_STATUS NdisFGetOptionalSwitchHandlers(
  [in]      NDIS_HANDLE                    NdisFilterHandle,
  [out]     PNDIS_SWITCH_CONTEXT           NdisSwitchContext,
  [in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);

매개 변수

[in] NdisFilterHandle

이 필터 모듈을 식별하는 NDIS 핸들입니다. NDIS가 확장의 FilterAttach 함수를 호출했을 때 NdisFilterHandle 매개 변수에서 이 핸들을 전달했습니다.

[out] NdisSwitchContext

확장이 연결된 확장 가능한 스위치 모듈을 식별하는 NDIS_SWITCH_CONTEXT 값에 대한 포인터입니다. 확장이 확장 가능한 스위치 처리기 함수를 호출하는 경우 NdisSwitchContext 매개 변수를 이 핸들의 값으로 설정해야 합니다.

[in, out] NdisSwitchHandlers

호출자가 할당한 NDIS_SWITCH_OPTIONAL_HANDLERS 구조체에 대한 포인터입니다. 호출이 성공하면 이 구조체에는 확장 가능한 스위치 처리기 함수에 대한 포인터 목록이 포함됩니다.

이러한 처리기 함수에 대한 자세한 내용은 Hyper-V 확장 가능한 스위치 처리기 함수를 참조하세요.

참고 확장이 NdisFGetOptionalSwitchHandlers를 호출하기 전에 NDIS_SWITCH_OPTIONAL_HANDLERS 구조체의 Header 멤버를 초기화해야 합니다.
 

반환 값

호출이 성공하면 NdisFGetOptionalSwitchHandlers는 NDIS_STATUS_SUCCESS 반환합니다. 그렇지 않으면 확장 가능한 스위치 확장이 기본 확장 스위치 구성 요소에 바인딩되지 않은 경우 NDIS_STATUS_NOT_SUPPORTED 반환합니다.

설명

확장은 FilterAttach 함수에서 NdisFGetOptionalSwitchHandlers 함수를 호출합니다.

확장이 여러 FilterMediaTypes INF 항목과 함께 설치된 경우 NdisFGetOptionalSwitchHandlers 를 호출하면 확장이 확장 가능한 스위치 또는 물리적 네트워크 어댑터에 대해 드라이버 스택에 바인딩되어 연결되어 있는지 여부를 확인할 수 있습니다. 호출이 NDIS_STATUS_SUCCESS 반환하면 확장이 확장 가능한 스위치 드라이버 스택 내에 연결됩니다. 호출이 NDIS_STATUS_NOT_SUPPORTED 반환하는 경우 확장은 실제 네트워크 어댑터에 대한 드라이버 스택 내에 연결됩니다.

확장 가능한 스위치 확장에 대한 FilterMediaTypes INF 항목에 대한 자세한 내용은 Hyper-V 확장 확장에 대한 INF 요구 사항을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 NDIS 6.30 이상에서 지원됩니다.
대상 플랫폼 유니버설
헤더 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL <= DISPATCH_LEVEL

추가 정보

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS