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 구조의 헤더 멤버를 초기화해야 합니다.

 

반환 값

호출이 성공하면 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