Функция WdfWmiProviderIsEnabled (wdfwmi.h)

  • Статья

[Относится только к KMDF]

Метод WdfWmiProviderIsEnabled определяет, включен ли сбор данных или уведомление о событиях для указанного поставщика данных WMI.

Синтаксис

BOOLEAN WdfWmiProviderIsEnabled(
  [in] WDFWMIPROVIDER           WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL ProviderControl
);

Параметры

[in] WmiProvider

Дескриптор объекта поставщика WMI, который драйвер получил, вызвав WdfWmiProviderCreate или WdfWmiInstanceGetProvider.

[in] ProviderControl

WDF_WMI_PROVIDER_CONTROL типизированное значение, указывающее один из типов функций управления (сбор данных или уведомление о событиях), которые может поддерживать поставщик данных WMI.

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

WdfWmiProviderIsEnabled возвращает значение TRUE , если включена возможность, указанная параметром ProviderControl , и false в противном случае.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Комментарии

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

Примеры

В следующем примере кода определяется, включено ли уведомление о событиях для указанного поставщика данных WMI.

BOOLEAN eventNotifEnabled;

eventNotifEnabled = WdfWmiProviderIsEnabled(
                                            wmiProvider,
                                            WdfWmiEventControl
                                            );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfwmi.h (включая Wdf.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы).
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также раздел

EvtWmiProviderFunctionControl

WDF_WMI_PROVIDER_CONTROL

WdfWmiInstanceGetProvider

WdfWmiProviderCreate