EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL回呼函式 (wdfwmi.h)

發行項
02/29/2024

[僅適用於 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 回呼函式，您的驅動程式必須在呼叫 WdfWmiProviderCreate 之前，將函式的位址放在WDF_WMI_PROVIDER_CONFIG結構中。

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

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

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