FWPS_VSWITCH_PORT_EVENT_CALLBACK0 콜백 함수(fwpsk.h)

아티클
02/29/2024

필터 엔진은 vSwitchPortEventNotifyFn (FWPS_VSWITCH_PORT_EVENT_CALLBACK0) 설명선 함수를 호출하여 설명선 드라이버에 vSwitch(가상 스위치) 포트와 연결된 이벤트에 대해 알립니다.

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 특정 버전의 FWPS_VSWITCH_PORT_EVENT_CALLBACK. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요.

구문

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 FwpsVswitchPortEventCallback0;

NTSTATUS FwpsVswitchPortEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_PORT_PARAMETERS *vSwitchPort
)
{...}

매개 변수

[in, optional] notifyContext

설명선 드라이버에서 제공하는 컨텍스트에 대한 포인터입니다. 드라이버는 FwpsvSwitchEventsSubscribe0 함수의 notifyContext 매개 변수에 이 포인터를 전달했습니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[in] completionContext

설명선 드라이버에서 제공하는 완료 컨텍스트에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[in] eventType

FWPS_VSWITCH_EVENT_TYPE 열거형 값 중 하나로 지정된 가상 스위치 vSwitch 이벤트의 형식입니다. 자세한 내용은 설명 부분을 참조하세요.

[in] vSwitch

가상 스위치에 대한 정보를 포함하는 NDIS_SWITCH_PARAMETERS 구조체에 대한 포인터입니다.

참고NDIS_SWITCH_PARAMETERS 구조체의 정보는 가상 스위치의 초기 상태를 반영하며 반드시 현재 상태는 아닙니다. 특히 가상 스위치 PnP 이벤트가 트리거되지 않는 한 NumSwitchPorts 및 IsActive 멤버의 초기 값은 0일 수 있습니다. 현재 상태 정보는 이 콜백 함수의 다른 매개 변수에서 찾을 수 있습니다.

[in] vSwitchPort

vSwitch의 포트에 대한 매개 변수를 포함하는 NDIS_SWITCH_PORT_PARAMETERS 구조체에 대한 포인터입니다.

반환 값

콜아웃의

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	설명선 드라이버는 필터 엔진의 알림을 수락합니다.
STATUS_PENDING	작업이 보류 중이며 나중에 완료됩니다. 설명선 드라이버는 FwpsvSwitchNotifyComplete0 함수를 호출하여 보류 중인 작업을 완료합니다.
기타 상태 코드	오류가 발생했습니다.

설명

설명선 드라이버는 FwpsvSwitchEventsSubscribe0 함수를 호출하여 vSwitchPortEventNotifyFn 함수를 등록합니다.

vSwitchPortEventNotifyFn 콜백이 등록된 경우 설명선 드라이버는 포트 만들기 및 삭제에 대한 알림을 받습니다.

eventType 매개 변수가 FWPS_VSWITCH_EVENT_PORT_CREATE 설정된 경우 vSwitch 포트가 생성되었습니다. 이 경우 vSwitch 매개 변수는 가상 스위치(vSwitch)에 대한 정보가 포함된 NDIS_SWITCH_PARAMETERS 구조를 식별하고 NDIS_SWITCH_PORT_PARAMETERS 매개 변수에는 포트에 대한 정보가 포함됩니다.

설명선은 vSwitchPortEventNotifyFn에서 STATUS_PENDING 반환할 수 있습니다. 이 경우 설명선 드라이버는 FwpsvSwitchNotifyComplete0 함수를 호출하여 보류 중인 작업을 완료합니다.

포트가 삭제된 후 WFP 필터 드라이버는 eventType 매개 변수에 설정된 FWPS_VSWITCH_EVENT_PORT_DELETE 사용하여 vSwitchPortEventNotifyFn을 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 사용하여 사용할 수 있습니다.
대상 플랫폼	Windows
헤더	fwpsk.h(Fwpsk.h 포함)
IRQL	<= DISPATCH_LEVEL