FwpmBfeStateSubscribeChanges0 函式 (fwpmk.h)

發行項
03/01/2024

FwpmBfeStateSubscribeChanges0 函式會註冊每當篩選引擎狀態變更時呼叫的回呼函式。

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

警告

請勿從您傳入回呼參數的回調函式呼叫 FwpmBfeStateUnsubscribeChanges0。這樣做可能會導致死結。

語法

NTSTATUS FwpmBfeStateSubscribeChanges0(
  [in, out]      void                                *deviceObject,
  [in]           FWPM_SERVICE_STATE_CHANGE_CALLBACK0 callback,
  [in, optional] void                                *context,
  [out]          HANDLE                              *changeHandle
);

參數

[in, out] deviceObject

先前由圖說文字驅動程式所建立之裝置物件的指標。如需圖說文字驅動程式如何建立裝置對象的詳細資訊，請參閱建立裝置物件。

[in] callback

圖說文字驅動程式所提供的服務狀態變更回呼函式的指標。每當篩選引擎的狀態有所變更時，篩選引擎就會呼叫此函式。

服務狀態變更回呼函式宣告如下。

VOID NTAPI
callback(
    IN OUT void  *context,
    IN FWPM_SERVICE_STATE  newState
    );

Context

圖說文字驅動程式呼叫 FwpmBfeStateSubscribeChanges0 函式時，傳入 Context 參數的指標。

newState

篩選引擎的新狀態。此參數包含下列其中一個值：

FWPM_SERVICE_STOPPED

篩選引擎未執行。

FWPM_SERVICE_START_PENDING

篩選引擎正在啟動。

FWPM_SERVICE_STOP_PENDING

篩選引擎正在停止。

FWPM_SERVICE_RUNNING

篩選引擎正在執行。

[in, optional] context

圖說文字驅動程式所提供內容的指標，傳遞至 Callback 參數中指定的回調函式。

[out] changeHandle

接收與回呼函式註冊相關聯句柄之變數的指標。圖說文字驅動程式會將此句柄傳遞給 FwpmBfeStateUnsubscribeChanges0 函式，以取消註冊回呼函式。

傳回值

FwpmBfeStateSubscribeChanges0 函式會傳回下列其中一個 NTSTATUS 代碼：

傳回碼	Description
STATUS_SUCCESS	已成功註冊回呼函式。
其他狀態代碼	發生錯誤。

備註

圖說文字驅動程式會呼叫 FwpmBfeStateSubscribeChanges0 函式，以註冊每當篩選引擎的狀態變更時呼叫的回呼函式。

例如，除非篩選引擎目前正在執行，否則圖說文字驅動程式無法藉由呼叫 FwpmEngineOpen0 函式來開啟篩選引擎的會話。圖說文字驅動程式可以使用 FWPM_SERVICE_RUNNING 通知來開啟篩選引擎的會話，以便呼叫其他 Windows 篩選平臺管理功能。同樣地，圖說文字驅動程式可以使用 FWPM_SERVICE_STOP_PENDING 通知，在篩選引擎停止之前執行任何清除。

圖說文字驅動程式必須先呼叫 FwpmBfeStateSubscribeChanges0 ，才能呼叫 FwpmBfeStateGet0 函式以擷取篩選引擎的目前狀態。呼叫 FwpmBfeStateSubscribeChanges0 之後，圖說文字驅動程式可以隨時呼叫 FwpmBfeStateGet0 。

圖說文字驅動程式必須藉由呼叫來取消註冊回呼函式在可卸除圖說文字驅動程式之前，FwpmBfeStateUnsubscribeChanges0 函式。

規格需求

需求	值
最低支援的用戶端	從 Windows Vista 開始提供。
目標平台	Universal
標頭	fwpmk.h (包含 Fwpmk.h)
程式庫	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

另請參閱

FwpmBfeStateGet0

FwpmBfeStateUnsubscribeChanges0

FwpmEngineOpen0

共用方式為