WdfWmiInstanceRegister-Funktion (wdfwmi.h)
[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 |
|---|---|
|
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) |