Condividi tramite


Funzione IoVolumeDeviceToDosName (ntddk.h)

La routine IoVolumeDeviceToDosName restituisce il percorso MS-DOS per un oggetto dispositivo specificato che rappresenta un volume del file system.

Sintassi

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

Parametri

[in] VolumeDeviceObject

Puntatore a un oggetto dispositivo che rappresenta un oggetto dispositivo volume creato da un driver di classe di archiviazione.

[out] DosName

Puntatore a una struttura di UNICODE_STRING allocata dal chiamante. Se la chiamata ha esito positivo, IoVolumeDeviceToDosName imposta i valori di Length, MaximumLengthe Buffer membri di questa struttura. All'uscita, il membro buffer di punta a una stringa con terminazione Null wide che contiene il percorso MS-DOS dell'oggetto dispositivo del volume specificato da VolumeDeviceObject. Per altre informazioni, vedere Osservazioni.

Valore restituito

IoVolumeDeviceToDosName restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti di errore possibili includono i codici di stato seguenti.

Valore restituito Descrizione
STATUS_INVALID_PARAMETER La routine non è riuscita a causa di valori di parametro non validi passati dal chiamante.
STATUS_INSUFFICIENT_RESOURCES La routine non è riuscita ad allocare le risorse necessarie per questa operazione.

Osservazioni

IoVolumeDeviceToDosName alloca il buffer di stringa a cui punta il membro buffer della struttura UNICODE_STRING a cui punta il parametro DosName. Dopo che questo buffer non è più necessario, un chiamante di questa routine deve chiamare la routine exFreePool per liberare il buffer.

A partire da Windows Vista, è necessario assicurarsi che le API non siano disabilitate prima di chiamare questa routine. La routine KeAreAllApcsDisabled per verificare che le API non siano disabilitate.

Fabbisogno

Requisito Valore
piattaforma di destinazione Universale
intestazione ntddk.h (include Ntddk.h)
libreria NtosKrnl.lib
dll NtosKrnl.exe
IRQL PASSIVE_LEVEL

Vedere anche

exFreePool

KeAreAllApcsDisabled

UNICODE_STRING