WdfDeviceAssignMofResourceName-Funktion (wdfdevice.h)

Artikel
02/29/2024

[Gilt nur für KMDF]

Die WdfDeviceAssignMofResourceName-Methode registriert einen MOF-Ressourcennamen für ein angegebenes Gerät.

Syntax

NTSTATUS WdfDeviceAssignMofResourceName(
  [in] WDFDEVICE        Device,
  [in] PCUNICODE_STRING MofResourceName
);

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] MofResourceName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die den Namen einer MOF-Ressource angibt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt WdfDeviceAssignMofResourceName STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_INVALID_DEVICE_REQUEST	Der Treiber hat bereits WdfDeviceAssignMofResourceName aufgerufen.
STATUS_INSUFFICIENT_RESOURCES	Nicht genügend Arbeitsspeicher ist verfügbar.

Die -Methode gibt möglicherweise andere NTSTATUS-Werte zurück.

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

Hinweise

Ein Treiber, der eine MOF-Datei zur Unterstützung von WMI bereitstellt, muss WdfDeviceAssignMofResourceName aufrufen, in der Regel aus seiner EvtDriverDeviceAdd - oder EvtDevicePrepareHardware-Rückruffunktion . Der Name der MOF-Ressource ist der Dateiname, den der Treiber in einer MofResource-Anweisung in seiner RC-Datei (Resource Script) angibt. Weitere Informationen zum Angeben eines MOF-Ressourcennamens finden Sie unter Kompilieren einer MOF-Datei des Treibers.

Ein Treiber, der die Geräte in einem Bus auflistet , kann WdfDeviceAssignMofResourceName für das übergeordnete Gerät aufrufen, und das Framework verwendet den MOF-Ressourcennamen des übergeordneten Elements für untergeordnete Geräte.

Weitere Informationen zu WMI finden Sie unter Unterstützung von WMI in Framework-Based Treibern.

Beispiele

Im folgenden Codebeispiel wird eine Unicode-Zeichenfolge deklariert, die einen MOF-Ressourcennamen darstellt, und dann den Namen registriert.

NTSTATUS  status;
DECLARE_CONST_UNICODE_STRING(mofRsrcName, MOFRESOURCENAME);

status = WdfDeviceAssignMofResourceName(
                                        Device,
                                        &mofRsrcName
                                        );
if (!NT_SUCCESS(status)) {
    return status;
}

Anforderungen

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

Freigeben über