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 UNICODE_STRING allocata dal chiamante. Se la chiamata ha esito positivo, IoVolumeDeviceToDosName imposta i valori dei membri Length, MaximumLength e Buffer di questa struttura. All'uscita, il membro Buffer punta a una stringa con terminazione Null a caratteri wide che contiene il percorso MS-DOS dell'oggetto dispositivo del volume specificato da VolumeDeviceObject. Per altre informazioni, vedere la sezione 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.

Commenti

IoVolumeDeviceToDosName alloca il buffer 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 SCHEDE APN non siano disabilitate prima di chiamare questa routine. La routine KeAreAllApcsDisabled può essere usata per verificare che le API non siano disabilitate.

Requisiti

Vedi anche

ExFreePool

KeAreAllApcsDisabled

UNICODE_STRING