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

  • Статья

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

Метод WdfWmiInstanceRegister регистрирует указанный экземпляр поставщика данных WMI в системной службе WMI.

Синтаксис

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

Параметры

[in] WmiInstance

Дескриптор объекта экземпляра WMI, полученный драйвером при предыдущем вызове WdfWmiInstanceCreate.

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

WdfWmiInstanceRegister возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод может возвращать одно из следующих значений:

Код возврата Описание
STATUS_INVALID_DEVICE_REQUEST
 Указанный экземпляр WMI уже зарегистрирован.
 

Этот метод также может возвращать другие значения NTSTATUS.

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

Комментарии

Экземпляры поставщика недоступны клиентам WMI до тех пор, пока они не будут зарегистрированы. Драйвер должен вызвать WdfWmiInstanceRegister или задать для элемента RegisterWDF_WMI_INSTANCE_CONFIG структуры экземпляра значение TRUE.

Дополнительные сведения о методе WdfWmiInstanceRegister см. в разделе Регистрация экземпляров поставщика. Дополнительные сведения о WMI см. в разделе Поддержка WMI в драйверах Framework-Based.

WdfWmiInstanceRegister регистрирует экземпляр поставщика синхронно (то есть перед возвратом), если он вызывается в IRQL = PASSIVE_LEVEL, и асинхронно, если он вызывается на PASSIVE_LEVEL IRQL > .

Примеры

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

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

Требования

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

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

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister