RtlVolumeDeviceToDosName function (ntddk.h)

Article
02/22/2024

The RtlVolumeDeviceToDosName routine is obsolete for Windows XP and later versions of Windows. Use IoVolumeDeviceToDosName instead.

RtlVolumeDeviceToDosName returns the MS-DOS path for a specified device object that represents a file system volume.

Syntax

NTSYSAPI NTSTATUS RtlVolumeDeviceToDosName(
  [in]  PVOID           VolumeDeviceObject,
  [out] PUNICODE_STRING DosName
);

Parameters

[in] VolumeDeviceObject

Pointer to a device object that represents a volume device object created by a storage class driver.

[out] DosName

Pointer to a Unicode string containing the MS-DOS path of the volume device object specified by VolumeDeviceObject.

Return value

RtlVolumeDeviceToDosName returns STATUS_SUCCESS or an appropriate error status.

Remarks

The behavior of this routine is identical to that of IoVolumeDeviceToDosName. For more information about how to use this routine, see IoVolumeDeviceToDosName.

Drivers that must work on older NT-based operating systems may use this routine. Drivers written for Windows XP and later must use IoVolumeDeviceToDosName instead.

Requirements

Requirement	Value
Minimum supported client	Obsolete for Microsoft Windows XP and later versions of Windows. Use IoVolumeDeviceToDosName instead.
Target Platform	Universal
Header	ntddk.h (include Ntddk.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe

Share via