Funzione WdfWmiInstanceRegister (wdfwmi.h)

[Si applica solo a KMDF]

Il metodo WdfWmiInstanceRegister registra un'istanza specificata di un provider di dati WMI con il servizio WMI del sistema.

Sintassi

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

Parametri

[in] WmiInstance

Handle a un oggetto istanza WMI ottenuto dal driver da una chiamata precedente a WdfWmiInstanceCreate.

Valore restituito

WdfWmiInstanceRegister restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:

Codice restituito Descrizione
STATUS_INVALID_DEVICE_REQUEST
L'istanza WMI specificata è già stata registrata.
 

Questo metodo potrebbe restituire anche altri valori NTSTATUS.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Le istanze del provider non sono disponibili per i client WMI fino a quando non sono state registrate. Il driver deve chiamare WdfWmiInstanceRegister o impostare il membro Register della struttura WDF_WMI_INSTANCE_CONFIG dell'istanza su TRUE.

Per altre informazioni sul metodo WdfWmiInstanceRegister , vedere Registrazione delle istanze del provider. Per altre informazioni su WMI, vedere Supporto di WMI nei driver di Framework-Based.

WdfWmiInstanceRegister registra l'istanza del provider in modo sincrono ,ovvero prima di restituire, se viene chiamata in IRQL = PASSIVE_LEVEL e asincronamente se viene chiamata in irQL > PASSIVE_LEVEL.

Esempio

Nell'esempio di codice seguente viene registrata un'istanza specificata di un provider di dati WMI con il servizio WMI del sistema.

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

Requisiti

   
Piattaforma di destinazione Universale
Versione KMDF minima 1,0
Intestazione wdfwmi.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister