Función IoVolumeDeviceToDosName (ntddk.h)
La rutina IoVolumeDeviceToDosName devuelve la ruta de acceso MS-DOS para un objeto de dispositivo especificado que representa un volumen del sistema de archivos.
Sintaxis
NTSTATUS IoVolumeDeviceToDosName(
[in] PVOID VolumeDeviceObject,
[out] PUNICODE_STRING DosName
);
Parámetros
[in] VolumeDeviceObject
Puntero a un objeto de dispositivo que representa un objeto de dispositivo de volumen creado por un controlador de clase de almacenamiento.
[out] DosName
Puntero a una estructura de UNICODE_STRING asignada por el autor de la llamada. Si la llamada se realiza correctamente, IoVolumeDeviceToDosName establece los valores de los miembros Length, MaximumLength y Buffer de esta estructura. Al salir, el miembro Buffer apunta a una cadena terminada en null de caracteres anchos que contiene la ruta de acceso MS-DOS del objeto de dispositivo de volumen especificado por VolumeDeviceObject. Para obtener más información, vea la sección Comentarios.
Valor devuelto
IoVolumeDeviceToDosName devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.
| Valor devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Error en la rutina debido a valores de parámetros no válidos pasados por el autor de la llamada. |
| STATUS_INSUFFICIENT_RESOURCES | La rutina no pudo asignar los recursos necesarios para esta operación. |
Comentarios
IoVolumeDeviceToDosName asigna el búfer de cadenas al que apunta el miembro Buffer de la estructura UNICODE_STRING a la que apunta el parámetro DosName . Una vez que este búfer ya no es necesario, un autor de llamada de esta rutina debe llamar a la rutina ExFreePool para liberar el búfer.
A partir de Windows Vista, debe asegurarse de que las API no están deshabilitadas antes de llamar a esta rutina. La rutina KeAreAllApcsDisabled se puede usar para comprobar que las API no están deshabilitadas.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ntddk.h (incluya Ntddk.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |