Funzione WdfWmiInstanceRegister (wdfwmi.h)

  • Articolo

[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 anche restituire altri valori NTSTATUS.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

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 di istanze del provider. Per altre informazioni su WMI, vedere Supporto di WMI nei driver Framework-Based.

WdfWmiInstanceRegister registra l'istanza del provider in modo sincrono ,ovvero prima di restituire, se viene chiamata in IRQL = PASSIVE_LEVEL e in modo asincrono 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

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfwmi.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister