共用方式為


FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0回呼函式 (fwpsk.h)

篩選引擎會呼叫 vSwitchRuntimeStateRestoreNotifyFnFWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) 圖說函式,以通知圖說文字驅動程式虛擬交換器運行時間狀態還原事件。

附註FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 是特定版本的 FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK。 如需詳細資訊,請參閱 糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。

 

語法

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 FwpsVswitchRuntimeStateRestoreCallback0;

NTSTATUS FwpsVswitchRuntimeStateRestoreCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           NDIS_SWITCH_PORT_ID portId,
                 void *runtimeState,
  [in]           SIZE_T runtimeStateLength
)
{...}

參數

[in, optional] notifyContext

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

[in] completionContext

圖說文字驅動程式所提供之完成內容的指標。 這個參數是選擇性的,而且可以是 NULL。

[in] eventType

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

[in] vSwitch

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

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

[in] portId

來源交換器埠標識碼。

runtimeState

運行時間狀態輸出結果緩衝區的位置。

[in] runtimeStateLength

運行時間狀態緩衝區中運行時間狀態信息的長度,以位元組為單位。

傳回值

圖說文字的

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

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

言論

圖說文字驅動程式會呼叫 FwpsvSwitchEventsSubscribe0 函式,以註冊 vSwitchRuntimeStateRestoreNotifyFn 函式。

如需儲存運行時間狀態的相關信息,請參閱 vSwitchRuntimeStateSaveNotifyFnFWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) 函式。

每個已儲存的數據區段都會在還原作業期間,透過目標系統上或本機系統上的虛擬交換器擴充堆疊傳送 OID_SWITCH_NIC_RESTORE OID 來還原。 糧食計劃署會在與已註冊的提供者 GUID 比對之後,透過 vSwitchRuntimeStateRestoreNotifyFn,將數據分派至正確的圖說文字。 在此情況下,vSwitchRuntimeStateRestoreNotifyFneventType 參數會設定為 FWPS_VSWITCH_EVENT_RUNTIME_STATE_RESTORE。

圖說文字可以從 vSwitchRuntimeStateRestoreNotifyFn傳回STATUS_PENDING。 在此情況下,WFP 會在 FilterOidRequest 處理程式中傳回STATUS_PENDING,並在稍後完成。 圖說驅動程式會呼叫 FwpsvSwitchNotifyComplete0 函式來完成暫止作業。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 窗戶
標頭 fwpsk.h (包括 Fwpsk.h)
IRQL <= DISPATCH_LEVEL

另請參閱

圖說驅動程式圖說文字函式

FWPS_VSWITCH_EVENT_TYPE

FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0

FilterOidRequest

FwpsvSwitchEventsSubscribe0

FwpsvSwitchNotifyComplete0

NDIS_SWITCH_PARAMETERS

OID_SWITCH_NIC_RESTORE