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 |
---|---|
|
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) |