WdfDeviceRetrieveDeviceDirectoryString-Funktion (wdfdevice.h)

[Gilt nur für UMDF]

WdfDeviceRetrieveDeviceDirectoryString stellt einen Pfad zu einem Speicherort auf dem Datenträger bereit, der zum Speichern von Informationen über Neustarts hinweg verwendet werden kann.

Syntax

NTSTATUS WdfDeviceRetrieveDeviceDirectoryString(
  [_In_] WDFDEVICE Device,
  [_In_] WDFSTRING String
);

Parameter

[_In_] Device

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

[_In_] String

Ein Handle für ein Frameworkzeichenfolgenobjekt. Das Framework weist dem Zeichenfolgenobjekt bei erfolgreicher Rückgabe den Verzeichnispfad zu.

Rückgabewert

Diese Funktion gibt NTSTATUS zurück. WdfDeviceRetrieveDeviceDirectoryString gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist.

Hinweise

Nur UMDF. KMDF-Treiber sollten IoGetDeviceDirectory verwenden.

Anforderungen

Anforderung Wert
UMDF-Mindestversion 2.25
Kopfzeile wdfdevice.h
IRQL PASSIVE_LEVEL

Weitere Informationen

Informationen zu Zeichenfolgenobjekten finden Sie unter Verwenden von Zeichenfolgenobjekten.