Функция IoVolumeDeviceToDosName (ntddk.h)

Статья
02/07/2025

Подпрограмма IoVolumeDeviceToDosName возвращает путь MS-DOS для указанного объекта устройства, представляющего том файловой системы.

Синтаксис

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

Параметры

[in] VolumeDeviceObject

Указатель на объект устройства, представляющий объект устройства тома, созданный драйвером класса хранилища.

[out] DosName

Указатель на структуру, выделенную вызывающим объектом, UNICODE_STRING. Если вызов выполнен успешно, IoVolumeDeviceToDosName задает значения длины, MaximumLengthи буферных элементов этой структуры. При выходе элемент буфера указывает на строку с широким символом, завершающуюся значением NULL, которая содержит путь MS-DOS объекта устройства тома, указанного VolumeDeviceObject. Дополнительные сведения см. в разделе "Примечания".

Возвращаемое значение

IoVolumeDeviceToDosName STATUS_SUCCESS возвращает STATUS_SUCCESS, если вызов выполнен успешно. Возможные значения возвращаемых ошибок включают следующие коды состояния.

Возвращаемое значение	Описание
STATUS_INVALID_PARAMETER	Подпрограмма завершилась ошибкой из-за недопустимых значений параметров, передаваемых вызывающим абонентом.
STATUS_INSUFFICIENT_RESOURCES	Подпрограмма не удалось выделить ресурсы, необходимые для этой операции.

Замечания

IoVolumeDeviceToDosName выделяет строковый буфер, на который указывает элемент буфера структуры UNICODE_STRING, на которую указывает параметр DosName . После того как этот буфер больше не требуется, вызывающий эту подпрограмму должен вызывать подпрограмму ExFreePool, чтобы освободить буфер.

Начиная с Windows Vista, перед вызовом этой процедуры необходимо убедиться, что API-интерфейсы не отключены. Подпрограмма keAreAllcsDisabled можно использовать для проверки того, что API-интерфейсы не отключены.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ntddk.h (include Ntddk.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

См. также

ExFreePool

KeAreAllcsDisabled

UNICODE_STRING

Поделиться через