Função IoVolumeDeviceToDosName (ntddk.h)
A rotina IoVolumeDeviceToDosName retorna o caminho MS-DOS para um objeto de dispositivo especificado que representa um volume do sistema de arquivos.
NTSTATUS IoVolumeDeviceToDosName(
[in] PVOID VolumeDeviceObject,
[out] PUNICODE_STRING DosName
);
[in] VolumeDeviceObject
Um ponteiro para um objeto de dispositivo que representa um objeto de dispositivo de volume criado por um driver de classe de armazenamento.
[out] DosName
Um ponteiro para uma estrutura de UNICODE_STRING alocada pelo chamador. Se a chamada for bem-sucedida, IoVolumeDeviceToDosName definirá os valores dos membros do Length, MaximumLengthe Buffer membros dessa estrutura. Na saída, o membro buffer de aponta para uma cadeia de caracteres de caractere largo e terminada em nulo que contém o caminho MS-DOS do objeto de dispositivo de volume especificado por VolumeDeviceObject. Para obter mais informações, consulte Comentários.
IoVolumeDeviceToDosName retorna STATUS_SUCCESS se a chamada for bem-sucedida. Os valores de retorno de erro possíveis incluem os seguintes códigos de status.
Valor de retorno | Descrição |
---|---|
STATUS_INVALID_PARAMETER | A rotina falhou devido a valores de parâmetro inválidos passados pelo chamador. |
STATUS_INSUFFICIENT_RESOURCES | A rotina falhou ao alocar os recursos necessários para esta operação. |
IoVolumeDeviceToDosName aloca o buffer de cadeia de caracteres apontado pelo membro do Buffer da estrutura UNICODE_STRING à qual o parâmetro DosName aponta. Depois que esse buffer não for mais necessário, um chamador dessa rotina deverá chamar a rotina de ExFreePool para liberar o buffer.
A partir do Windows Vista, você deve garantir que as APCs não estejam desabilitadas antes de chamar essa rotina. A rotina de KeAreAllApcsDisabled pode ser usada para verificar se as APCs não estão desabilitadas.
Requisito | Valor |
---|---|
da Plataforma de Destino | Universal |
cabeçalho | ntddk.h (inclua Ntddk.h) |
biblioteca | NtosKrnl.lib |
de DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |