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.