функция обратного вызова EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL (wdfwmi.h)

Статья
02/27/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, указывает на то, что драйвер должен включить возможность, заданную элементом управления . Если значение FALSE, драйвер должен отключить эту возможность.

Возвращаемое значение

Функция обратного вызова EvtWmiProviderFunctionControl должна возвращать STATUS_SUCCESS, если операция выполнена успешно. В противном случае он должен возвращать значение состояния, для которого NT_SUCCESS(status) равно FALSE.

Если драйвер устанавливает флаг WdfWmiProviderExpensive в элементе Flagsструктуры WDF_WMI_PROVIDER_CONFIG поставщика данных WMI и если драйвер предоставляет функцию обратного вызова EvtWmiProviderFunctionControl , платформа вызывает функцию обратного вызова, когда драйвер должен включить или отключить возможность сбора данных WMI.

Вместо функции обратного вызова EvtWmiProviderFunctionControl драйвер может вызвать WdfWmiProviderIsEnabled , чтобы узнать, следует ли включать или отключать сбор данных.

Дополнительные сведения о функции обратного вызова EvtWmiProviderFunctionControl см. в разделе Поддержка WMI в драйверах Framework-Based.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Верхняя часть	wdfwmi.h (включая Wdf.h)
IRQL	PASSIVE_LEVEL