WdfWmiInstanceRegister-Funktion (wdfwmi.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfWmiInstanceRegister-Methode registriert eine angegebene instance eines WMI-Datenanbieters beim WMI-Dienst des Systems.

Syntax

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

Parameter

[in] WmiInstance

Ein Handle für ein WMI-instance-Objekt, 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-instance 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.

Hinweise

Anbieterinstanzen sind für WMI-Clients erst verfügbar, wenn sie registriert wurden. Ihr Treiber muss entweder WdfWmiInstanceRegister aufrufen oder den Register-Member der WDF_WMI_INSTANCE_CONFIG-Struktur des instance 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 den Anbieter instance synchron (d. h. vor der Rückgabe), wenn er unter IRQL = PASSIVE_LEVEL aufgerufen wird, und asynchron, wenn er am IRQL-PASSIVE_LEVEL > aufgerufen wird.

Beispiele

Im folgenden Codebeispiel wird eine angegebene instance eines WMI-Datenanbieters beim WMI-Dienst des Systems registriert.

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfwmi.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister