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

[Применимо только к KMDF]

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

Синтаксис

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

Параметры

[in] WmiInstance

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

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

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

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

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

Замечания

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

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

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

Примеры

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

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

Требования

См. также

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister