FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0回呼函式 (fwpsk.h)
篩選引擎會呼叫 vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) 圖說文字函式,以通知圖說文字驅動程式建立和刪除虛擬交換器的事件。
語法
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 結構的指標。
[in, optional] vSwitchPorts
指定埠組態參數陣列之 NDIS_SWITCH_PORT_ARRAY 結構的指標。 陣列中的每個元素都會指定虛擬交換器上埠的參數。
[in, optional] vSwitchInterfaces
指定迷你埠配接器組態參數陣列之 NDIS_SWITCH_NIC_ARRAY 結構的指標。 數位中的每個元素都會指定虛擬或實體迷你埠配接器的參數,這些配接器會附加至虛擬交換器上的埠。
傳回值
圖說文字的
FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 函式會傳回下列其中一個NTSTATUS程式代碼。
傳回碼 | 描述 |
---|---|
|
圖說文字驅動程式接受來自篩選引擎的通知。 |
|
發生錯誤。 |
言論
圖說驅動程式會藉由呼叫 來註冊 vSwitchLifetimeNotifyFn 回呼函式
FwpsvSwitchEventsSubscribe0 函式。
如果註冊 vSwitchLifetimeNotifyFn 回呼,則 WFP 篩選驅動程式會在建立虛擬交換器實例時通知圖說驅動程式。 虛擬交換器的多個實例可以同時存在於 Hyper-V 主機中。
WFP 篩選驅動程式會查詢 FilterRestart 函式中的 OID_SWITCH_PARAMETERS OID,以取得與虛擬交換器目前實例相關聯的虛擬交換器標識碼。 WFP 篩選驅動程式也會查詢 OID_SWITCH_NIC_ARRAY 和 OID_SWITCH_PORT_ARRAY OID,以取得初始設定的虛擬 NIC 和虛擬埠集。 WFP 篩選驅動程式會將 OID 中的 NDIS_SWITCH_PORT_ARRAY 和 NDIS_SWITCH_NIC_ARRAY 結構資訊傳遞至 vSwitchLifetimeNotifyFn,並在 eventType 參數中設定FWPS_VSWITCH_EVENT_VSWITCH_CREATE。
在 WFP 篩選驅動程式的 FilterDetach中,篩選會呼叫 eventTypevSwitchLifetimeNotifyFn 參數中設定FWPS_VSWITCH_EVENT_VSWITCH_DELETE。
圖說文字驅動程式無法從 vSwitchLifetimeNotifyFn傳回STATUS_PENDING。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始提供。 |
目標平臺 | 窗戶 |
標頭 | fwpsk.h (包括 Fwpsk.h) |
IRQL | <= DISPATCH_LEVEL |