функция обратного вызова EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL (wdfwmi.h)
[Применимо только к 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.
Если драйвер задает флаг WdfWmiProviderExpens ive в Flags члена WDF_WMI_PROVIDER_CONFIG поставщика данных WMI, а драйвер предоставляет функцию обратного вызова EvtWmiProviderFunctionControl, платформа вызывает функцию обратного вызова, когда драйвер должен включить или отключить возможность сбора данных WMI.
Вместо предоставления функции обратного вызова EvtWmiProviderFunctionControl драйвер может вызывать WdfWmiProviderIsEnabled, чтобы узнать, следует ли включить или отключить сбор данных.
Дополнительные сведения о функции обратного вызова EvtWmiProviderFunctionControl см. в поддержке WMI в драйверахFramework-Based.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| минимальная версия KMDF | 1.0 |
| заголовка | wdfwmi.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |