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 驱动程序中支持 WMI。