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 回调函数，驱动程序必须在调用 WdfWmiProviderCreate之前将函数的地址置于 WDF_WMI_PROVIDER_CONFIG 结构中。

如果驱动程序在 WMI 数据提供程序 WDF_WMI_PROVIDER_CONFIG 结构的 Flags 成员中设置 WdfWmiProviderExpensive 标志，并且驱动程序提供 EvtWmiProviderFunctionControl 回调函数，则当驱动程序应启用或禁用收集 WMI 数据的能力时，框架将调用回调函数。

驱动程序无需提供 EvtWmiProviderFunctionControl 回调函数，而是可以调用 WdfWmiProviderIsEnabled，以确定它是否应启用或禁用收集数据。

有关 EvtWmiProviderFunctionControl 回调函数的详细信息，请参阅 Framework-Based Drivers 中的支持 WMI。