FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0回呼函式 (fwpsk.h)

發行項
02/26/2024

篩選引擎會呼叫 vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) 圖說文字函式，以通知圖說文字驅動程式建立和刪除虛擬交換器的事件。

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

語法

FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 FwpsVswitchLifetimeEventCallback0;

NTSTATUS FwpsVswitchLifetimeEventCallback0(
  [in, optional] void *notifyContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_ARRAY *vSwitchPorts,
  [in, optional] const NDIS_SWITCH_NIC_ARRAY *vSwitchInterfaces
)
{...}

參數

[in, optional] notifyContext

圖說文字驅動程式所提供之內容的指標。驅動程式已將此指標傳遞至 FwpsvSwitchEventsSubscribe0 函式的 notifyContext 參數。這個參數是選擇性的，而且可以是 NULL。

[in] eventType

指定為其中一個 FWPS_VSWITCH_EVENT_TYPE 列舉值的虛擬交換器事件類型。如需詳細資訊，請參閱＜備註＞。

[in] vSwitch

包含虛擬交換器相關信息之NDIS_SWITCH_PARAMETERS 結構的指標。

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

[in, optional] vSwitchPorts

指定埠組態參數陣列之NDIS_SWITCH_PORT_ARRAY 結構的指標。陣列中的每個元素都會指定虛擬交換器上埠的參數。

[in, optional] vSwitchInterfaces

指定迷你埠配接器組態參數陣列之NDIS_SWITCH_NIC_ARRAY 結構的指標。數位中的每個元素都會指定虛擬或實體迷你埠配接器的參數，這些配接器會附加至虛擬交換器上的埠。

傳回值

圖說文字的

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

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

備註

圖說文字驅動程式會藉由呼叫來註冊 vSwitchLifetimeNotifyFn 回呼函式
FwpsvSwitchEventsSubscribe0 函式。

如果 已註冊 vSwitchLifetimeNotifyFn 回呼，則一建立虛擬交換器實例時，則一併通知圖說文字驅動程式。虛擬交換器的多個實例可以同時出現在 Hyper-V 主機中。

在 FilterRestart 函式中查詢OID_SWITCH_PARAMETERS OID，以取得與虛擬交換器目前實例相關聯的虛擬交換器標識碼。在一組設定的虛擬 NIC 和虛擬埠的初始集合中，則一併查詢OID_SWITCH_NIC_ARRAY和 OID_SWITCH_PORT_ARRAY OID。在 eventType 參數中設定FWPS_VSWITCH_EVENT_VSWITCH_CREATE，將NDIS_SWITCH_PORT_ARRAY和NDIS_SWITCH_NIC_ARRAY結構資訊從 OID 傳遞至 vSwitchLifetimeNotifyFn。

在FWPS_VSWITCH_EVENT_VSWITCH_DELETE設定於 eventTypevSwitchLifetimeNotifyFn 參數中的 FILTER 驅動程式 FilterDetach 中，篩選會呼叫。

圖說文字驅動程式無法從 vSwitchLifetimeNotifyFn 傳回STATUS_PENDING。