FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 콜백 함수(fwpsk.h)
필터 엔진은 vSwitchInterfaceEventNotifyFn(FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) 설명선 함수를 호출하여 설명선 드라이버에 가상 스위치 인터페이스와 연결된 이벤트에 대해 알립니다.
통사론
FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 FwpsVswitchInterfaceEventCallback0;
NTSTATUS FwpsVswitchInterfaceEventCallback0(
[in, optional] void *notifyContext,
[in] void *completionContext,
[in] FWPS_VSWITCH_EVENT_TYPE eventType,
[in] const NDIS_SWITCH_PARAMETERS *vSwitch,
[in] const NDIS_SWITCH_NIC_PARAMETERS *vSwitchNic
)
{...}
매개 변수
[in, optional] notifyContext
설명선 드라이버에서 제공하는 컨텍스트에 대한 포인터입니다. 드라이버는 FwpsvSwitchEventsSubscribe0 함수의 notifyContext 매개 변수에 이 포인터를 전달했습니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] completionContext
설명선 드라이버에서 제공하는 완료 컨텍스트에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] eventType
FWPS_VSWITCH_EVENT_TYPE 열거형 값 중 하나로 지정된 가상 스위치 이벤트의 형식입니다. 자세한 내용은 비고를 참조하세요.
[in] vSwitch
가상 스위치에 대한 정보를 포함하는 NDIS_SWITCH_PARAMETERS 구조체에 대한 포인터입니다.
[in] vSwitchNic
가상 스위치 포트에 연결된 가상 미니포트 어댑터의 매개 변수를 지정하는 NDIS_SWITCH_NIC_PARAMETERS 구조체에 대한 포인터입니다.
반환 값
설명선
FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
|
설명선 드라이버는 필터 엔진의 알림을 수락합니다. |
|
오류가 발생했습니다. |
발언
설명선 드라이버가
호출하여 vSwitchInterfaceEventNotifyFn 함수를
FwpsvSwitchEventsSubscribe0 함수입니다.
eventType 매개 변수가 WPS_VSWITCH_EVENT_INTERFACE_CREATE 설정되면 가상 스위치 포트와 네트워크 어댑터 간의 새 네트워크 연결이 완전히 설정됩니다. vSwitchNic 매개 변수는 가상 스위치 포트에 연결된 가상 네트워크 어댑터에 대한 정보를 포함하는 NDIS_SWITCH_NIC_PARAMETERS 구조를 식별합니다.
eventType 매개 변수가 FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT 가상 스위치 포트와 네트워크 어댑터 간의 연결이 낮아집니다. 연결이 완전히 중단된 후 WFP 필터 드라이버는 eventType 매개 변수에 설정된 FWPS_VSWITCH_EVENT_INTERFACE_DELETE 사용하여 vSwitchInterfaceEventNotifyFn 호출합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8부터 사용할 수 있습니다. |
| 대상 플랫폼 | Windows |
| 헤더 | fwpsk.h(Fwpsk.h 포함) |
| IRQL | <= DISPATCH_LEVEL |