WdfDeviceRetrieveDeviceDirectoryString function (wdfdevice.h)

[Applies to UMDF only]

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

Syntax

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

Parameters

[_In_] Device

A handle to a framework device object.

[_In_] String

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

Requirement Value
Minimum UMDF version 2.25
Header wdfdevice.h
IRQL PASSIVE_LEVEL

See also

For info about string objects, see Using String Objects.