WdfDeviceAssignMofResourceName-Funktion (wdfdevice.h)

Artikel
07.02.2025

[Gilt nur für KMDF]

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

Syntax

C++

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

Parameter

[in] Device

Ein Handle zu einem 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 WdfDeviceAssignMofResourceNameaufgerufen.
STATUS_INSUFFICIENT_RESOURCES	Nicht genügend Arbeitsspeicher verfügbar.

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

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

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

Ein Treiber , der die Geräte auf einem Bus aufzählt, 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ützen von WMI in Framework-Based Drivers.

Beispiele

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

C++

NTSTATUS  status;
DECLARE_CONST_UNICODE_STRING(mofRsrcName, MOFRESOURCENAME);

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

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über