IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS IOCTL (ehstorbandmgmt.h)

  • Articolo

Questa IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS richiesta viene inviata per recuperare l'elenco di bande per un dispositivo di archiviazione sotto la gestione della banda. Le informazioni sulla banda vengono restituite in una tabella di voci band che includono le proprietà di sicurezza e posizione band.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il buffer in Irp-AssociatedIrp.SystemBuffer> deve contenere una struttura ENUMERATE_BANDS_PARAMETERS.

Lunghezza del buffer di input

Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer, che deve essere almeno sizeof (ENUMERATE_BANDS_PARAMETERS).

Buffer di output

Il buffer in Irp-AssociatedIrp.SystemBuffer> contiene una struttura BAND_TABLE seguita dalle voci band BandTableEntryCount.

Lunghezza del buffer di output

Lunghezza di una struttura BAND_TABLE seguita dalle voci band BandTableEntryCount .

Blocco dello stato

Il campo Informazioni contiene il numero di byte restituiti nel buffer di output. Uno dei valori seguenti può essere restituito nel campo Stato .

Valore stato Descrizione
STATUS_SUCCESS Le funzionalità di sicurezza nel dispositivo di archiviazione sono state disattivate.
STATUS_INVALID_DEVICE_REQUEST Il dispositivo di archiviazione non supporta la gestione della banda.
STATUS_INVALID_BUFFER_SIZE Le dimensioni del buffer di input non sono valide.
STATUS_INVALID_PARAMETER Le informazioni nel buffer di input non sono valide.
STATUS_NOT_FOUND Non sono configurate bande per i parametri di enumerazione specificati.
STATUS_BUFFER_OVERFLOW Un buffer non viene fornito o le relative dimensioni impostate su zero. Le dimensioni necessarie vengono restituite nel campo Informazioni .
STATUS_IO_DEVICE_ERROR Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza.
STATUS_BUFFER_TOO_SMALL Il buffer di output fornito non è abbastanza grande per contenere i dati di output restituiti.

Commenti

Un driver o un'applicazione può eseguire una query sulla dimensione del buffer di output necessaria impostando il buffer di output per la richiesta su NULL e le dimensioni di output su 0. La richiesta di IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS restituirà con il campo Stato del blocco IoStatus impostato su STATUS_BUFFER_OVERFLOW e il campo Informazioni conterrà le dimensioni del buffer necessarie.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Intestazione ehstorbandmgmt.h (include EhStorBandMgmt.h)

Vedi anche

BAND_TABLE

ENUMERATE_BANDS_PARAMETERS