FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0回呼函式 (fwpsk.h)

發行項
02/29/2024

篩選引擎會呼叫 vSwitchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) 圖說文字函式，以通知圖說文字驅動程式有關與虛擬交換器介面相關聯的事件。

注意FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 是特定版本的 FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK。如需詳細資訊，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標。

語法

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 結構的指標。

注意NDIS_SWITCH_PARAMETERS 結構中的資訊會反映虛擬交換器的初始狀態，不一定是其目前狀態。特別是，除非已觸發虛擬交換器 PnP 事件， 否則 NumSwitchPorts 和 IsActive 成員可能仍然有其初始值為零。您可以在這個回呼函式的其他參數中找到目前的狀態資訊。

[in] vSwitchNic

NDIS_SWITCH_NIC_PARAMETERS 結構的指標，指定連接到虛擬交換器埠之虛擬迷你埠配接器的參數。

傳回值

圖說文字的

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

傳回碼	Description
STATUS_SUCCESS	圖說文字驅動程式會接受來自篩選引擎的通知。
其他狀態代碼	發生錯誤。

備註

圖說驅動程式會註冊
vSwitchInterfaceEventNotifyFn 函式，方法是呼叫
FwpsvSwitchEventsSubscribe0 函式。

如果 eventType 參數設定為 WPS_VSWITCH_EVENT_INTERFACE_CREATE，則會完全建立虛擬交換器埠與網路適配器之間的新網路連線。 vSwitchNic 參數會識別NDIS_SWITCH_NIC_PARAMETERS結構，其中包含連線至虛擬交換器埠之虛擬網路適配器的相關信息。

如果 eventType 參數FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT，虛擬交換器埠與網路適配器之間的連線就會中斷。聯機完全損毀之後，一般會呼叫 VSwitchInterfaceEventNotifyFn ，並在 eventType 參數中設定FWPS_VSWITCH_EVENT_INTERFACE_DELETE。