Ler em inglês

Compartilhar via


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.

Sintaxe

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

Parâmetros

[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.

Valor de retorno

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.

Observações

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.

Requisitos

Requisito Valor
da Plataforma de Destino Universal
cabeçalho ntddk.h (inclua Ntddk.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Consulte também

ExFreePool

KeAreAllApcsDisabled

UNICODE_STRING