WdfDeviceRetrieveDeviceDirectoryString function

WdfDeviceRetrieveDeviceDirectoryString provides a path to a location on disk that can be used to persist information across reboots.

Syntax

NTSTATUS WdfDeviceRetrieveDeviceDirectoryString(
  WDFDEVICE Device,
  WDFSTRING String
);

Parameters

Device

[In] A handle to a framework device object.

String

[In] A handle to a framework string object. The framework will assign the directory path to the string object on successful return.

Return Value

This function returns NTSTATUS. WdfDeviceRetrieveDeviceDirectoryString returns STATUS_SUCCESS if the operation succeeds.

Remarks

UMDF only. KMDF drivers should use IoGetDeviceDirectory.

Requirements

   
Minimum UMDF version 2.25
Header wdfdevice.h
IRQL PASSIVE_LEVEL

See Also

For info about string objects, see Using String Objects.