Compartir a través de


Función WdfWmiInstanceRegister (wdfwmi.h)

[Solo se aplica a KMDF]

El método WdfWmiInstanceRegister registra una instancia especificada de un proveedor de datos WMI con el servicio WMI del sistema.

Sintaxis

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

Parámetros

[in] WmiInstance

Identificador de un objeto de instancia de WMI que el controlador obtuvo de una llamada anterior a WdfWmiInstanceCreate.

Valor devuelto

WdfWmiInstanceRegister devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método podría devolver uno de los siguientes valores:

Código devuelto Descripción
STATUS_INVALID_DEVICE_REQUEST
La instancia de WMI especificada ya se ha registrado.
 

Este método también puede devolver otros valores de NTSTATUS.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Observaciones

Las instancias del proveedor no están disponibles para los clientes WMI hasta que se hayan registrado. El controlador debe llamar a WdfWmiInstanceRegister o establecer el miembro Register de la estructura de WDF_WMI_INSTANCE_CONFIG de la instancia en TRUE.

Para obtener más información sobre el método WdfWmiInstanceRegister, consulte Registro de instancias de proveedor. Para obtener más información sobre WMI, vea compatibilidad con WMI en controladores de Framework-Based.

WdfWmiInstanceRegister registra la instancia del proveedor de forma sincrónica (es decir, antes de devolver) si se llama a IRQL = PASSIVE_LEVEL y asincrónicamente si se llama a en IRQL > PASSIVE_LEVEL.

Ejemplos

En el ejemplo de código siguiente se registra una instancia especificada de un proveedor de datos WMI con el servicio WMI del sistema.

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

Requisitos

Requisito Valor
de la plataforma de destino de Universal
versión mínima de KMDF 1.0
encabezado de wdfwmi.h (incluya Wdf.h)
biblioteca de Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
irQL <=DISPATCH_LEVEL
reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCrear

WdfWmiInstanceDeregister