EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL回呼函式（wdfwmi.h）

發行項
02/07/2025

[僅適用於 KMDF]

驅動程式的 EvtWmiProviderFunctionControl 回呼函式會啟用和停用驅動程式針對指定 WMI 數據提供者收集數據和傳送事件的支援。

語法

EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;

NTSTATUS EvtWdfWmiProviderFunctionControl(
  [in] WDFWMIPROVIDER WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL Control,
  [in] BOOLEAN Enable
)
{...}

參數

[in] WmiProvider

WMI 提供者物件的句柄。

[in] Control

WDF_WMI_PROVIDER_CONTROL型別值，識別驅動程式必須啟用或停用的功能。

[in] Enable

布爾值，如果 TRUE，表示驅動程式必須啟用 Control 指定的功能。如果 FALSE，驅動程式必須停用此功能。

傳回值

EvtWmiProviderFunctionControl 回呼函式必須在作業成功時傳回STATUS_SUCCESS。否則，它必須傳回狀態值，NT_SUCCESS（狀態）等於 false。

言論

若要註冊 EvtWmiProviderFunctionControl 回呼函式，您的驅動程式必須先將函式的位址放在 WDF_WMI_PROVIDER_CONFIG 結構中，才能呼叫 WdfWmiProviderCreate。

如果您的驅動程式在 旗標中設定 WdfWmiProviderExpensive 旗標， WMI 數據提供者 WDF_WMI_PROVIDER_CONFIG 結構的成員，而如果驅動程式提供 EvtWmiProviderFunctionControl 回呼函式，則架構會在驅動程式應該啟用或停用收集 WMI 數據的能力時呼叫回呼函式。

驅動程式不需要提供 EvtWmiProviderFunctionControl 回呼函式，而是可以呼叫 WdfWmiProviderIsEnabled，以找出它是否應該啟用或停用收集數據。

如需 EvtWmiProviderFunctionControl 回呼函式的詳細資訊，請參閱 Framework-Based Drivers中支援 WMI。