WdfDeviceInitAssignName-Funktion (wdfdevice.h)

Artikel
07/16/2024

[Gilt nur für KMDF]

Die WdfDeviceInitAssignName--Methode weist dem Geräteobjekt eines Geräts einen Gerätenamen zu.

Syntax

NTSTATUS WdfDeviceInitAssignName(
  [in]           PWDFDEVICE_INIT  DeviceInit,
  [in, optional] PCUNICODE_STRING DeviceName
);

Parameter

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT Struktur.

[in, optional] DeviceName

Ein Zeiger auf eine UNICODE_STRING Struktur, die den Gerätenamen darstellt.

Rückgabewert

Wenn WdfDeviceInitAssignName keine Fehler zurückgibt, wird STATUS_SUCCESS zurückgegeben. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Das System kann keinen Speicherplatz zuordnen, um den Gerätenamen zu speichern.

Bemerkungen

Wenn ein Treiber WdfDeviceInitAssignNameaufruft, muss er dies tun, bevor er WdfDeviceCreateaufruft.

Wenn ein Treiber WdfDeviceInitAssignName aufruft, um einen Namen zuzuweisen, kann der Treiber anschließend WdfDeviceInitAssignName- mit einem NULL-DeviceName Parameter aufrufen, um den Gerätenamen zu löschen. Wenn der Gerätename NULL- ist und das Geräteobjekt einen Namen erfordert (da er ein PDO oder ein Steuerelementgerätdarstellt), erstellt das Betriebssystem einen Namen.

Weitere Informationen zum Benennen von Geräteobjekten finden Sie unter Steuern des Gerätezugriffs in Framework-Based Drivers.

Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.

Beispiele

Im folgenden Codebeispiel wird einem Gerät ein NT-Gerätename zugewiesen.

DECLARE_CONST_UNICODE_STRING(MyDeviceName, L"\\Device\\Ramdisk") ;
status = WdfDeviceInitAssignName(
                                 DeviceInit,
                                 &MyDeviceName
                                 );
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	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate (kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(km), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), Pdo, PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf)

Siehe auch

WdfDeviceRetrieveDeviceName

Freigeben über