WdfWmiInstanceRegister-Funktion (wdfwmi.h)

[Gilt nur für KMDF]

Die WdfWmiInstanceRegister-Methode registriert eine angegebene Instanz eines WMI-Datenanbieters mit dem WMI-Dienst des Systems.

Syntax

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

Parameter

[in] WmiInstance

Ein Handle zu einem WMI-Instanzobjekt, das der Treiber aus einem vorherigen Aufruf von WdfWmiInstanceCreate abgerufen hat.

Rückgabewert

WdfWmiInstanceRegister gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_INVALID_DEVICE_REQUEST
Die angegebene WMI-Instanz wurde bereits registriert.
 

Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Bemerkungen

Anbieterinstanzen stehen WMI-Clients erst zur Verfügung, wenn sie registriert wurden. Ihr Treiber muss entweder WdfWmiInstanceRegister aufrufen oder das Register-Element der WDF_WMI_INSTANCE_CONFIG Struktur der Instanz auf TRUE festlegen.

Weitere Informationen zur WdfWmiInstanceRegister-Methode finden Sie unter Registrieren von Anbieterinstanzen. Weitere Informationen zu WMI finden Sie unter Unterstützung von WMI in Framework-Based Treibern.

WdfWmiInstanceRegister registriert die Anbieterinstanz synchron (d. h. vor der Rückgabe), wenn sie bei IRQL = PASSIVE_LEVEL und asynchron aufgerufen wird, wenn sie bei IRQL-PASSIVE_LEVEL > aufgerufen wird.

Beispiele

Im folgenden Codebeispiel wird eine angegebene Instanz eines WMI-Datenanbieters mit dem WMI-Dienst des Systems registriert.

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

Anforderungen

   
Zielplattform Universell
KMDF-Mindestversion 1.0
Header wdfwmi.h (einschließen Wdf.h)
Bibliothek Wdf01000.sys (siehe Framework-Bibliotheksversioning.)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister