FWPS_VSWITCH_PORT_EVENT_CALLBACK0回呼函式（fwpsk.h）

發行項
02/06/2025

篩選引擎會呼叫 vSwitchPortEventNotifyFn （FWPS_VSWITCH_PORT_EVENT_CALLBACK0）圖說函式，以通知圖說文字驅動程式與虛擬交換器（vSwitch）埠相關聯的事件。

附註FWPS_VSWITCH_PORT_EVENT_CALLBACK0 是特定版本的 FWPS_VSWITCH_PORT_EVENT_CALLBACK。如需詳細資訊，請參閱糧食計劃署 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 成員可能仍有其初始值為零。目前的狀態資訊可以在這個回呼函式的其他參數中找到。

[in] vSwitchPort

NDIS_SWITCH_PORT_PARAMETERS 結構的指標，其中包含 vSwitch 上埠的參數。

傳回值

圖說文字的

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 函式會傳回下列其中一個NTSTATUS代碼。

傳回碼	描述
STATUS_SUCCESS	圖說文字驅動程式接受來自篩選引擎的通知。
STATUS_PENDING	作業擱置中，稍後將會完成。圖說驅動程式會呼叫 FwpsvSwitchNotifyComplete0 函式來完成暫止作業。
其他狀態代碼	發生錯誤。

言論

圖說文字驅動程式會呼叫 FwpsvSwitchEventSubscribe0 函式，以註冊 vSwitchPortEventNotifyFn 函式。

如果註冊 vSwitchPortEventNotifyFn 回呼，圖說驅動程式會收到埠建立和刪除的通知。

如果 eventType 參數設定為 FWPS_VSWITCH_EVENT_PORT_CREATE，則會建立 vSwitch 埠。在此情況下，vSwitch 參數會識別 NDIS_SWITCH_PARAMETERS 結構，其中包含虛擬交換器（vSwitch）的相關信息，而 NDIS_SWITCH_PORT_PARAMETERS 參數包含埠的相關信息。

圖說文字可以從 vSwitchPortEventNotifyFn傳回STATUS_PENDING。在此情況下，圖說文字驅動程式會呼叫 FwpsvSwitchNotifyComplete0 函式來完成暫止作業。

刪除埠之後，WFP 篩選驅動程式會呼叫 vSwitchPortEventNotifyFn，並在 eventType 參數中設定FWPS_VSWITCH_EVENT_PORT_DELETE。