Freigeben über


WdfDeviceRetrieveDeviceDirectoryString-Funktion (wdfdevice.h)

[Gilt nur für UMDF]

WdfDeviceRetrieveDeviceDirectoryString einen Pfad zu einem Speicherort auf dem Datenträger bereitstellt, 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 zu einem Framework-Geräteobjekt.

[_In_] String

Ein Handle für ein Framework-Zeichenfolgenobjekt. 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.

Bemerkungen

Nur UMDF. KMDF-Treiber sollten IoGetDeviceDirectory-verwenden.

Anforderungen

Anforderung Wert
Mindest-UMDF-Version 2.25
Header- wdfdevice.h
IRQL- PASSIVE_LEVEL

Siehe auch

Informationen zu Zeichenfolgenobjekten finden Sie unter Verwenden von Zeichenfolgenobjekten.