Función WdfWmiInstanceRegister (wdfwmi.h)

  • Artículo

[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 podría devolver otros valores NTSTATUS.

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

Comentarios

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 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 en IRQL = PASSIVE_LEVEL y de forma asincrónica 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 Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfwmi.h (incluir Wdf.h)
Library 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

WdfWmiInstanceCreate

WdfWmiInstanceDeregister