IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS IOCTL (ehstorbandmgmt.h)

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

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il buffer in corrispondenza 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 devono essere almeno sizeof (ENUMERATE_BANDS_PARAMETERS).

Buffer di output

Il buffer in corrispondenza di Irp->AssociatedIrp.SystemBuffer contiene una struttura BAND_TABLE seguita da Voci bandTableEntryCount.

Lunghezza del buffer di output

Lunghezza di una struttura BAND_TABLE seguita da Voci bandTableEntryCount.

Blocco di stato

Il campo Informazioni contiene il numero di byte restituiti nel buffer di output. È possibile restituire uno dei valori seguenti nel campo Stato.

Valore di 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	La dimensione del buffer di input non è valida.
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 dimensioni impostate su zero. La dimensione richiesta viene restituita 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 è sufficientemente grande da contenere i dati di output restituiti.

Osservazioni

Un driver o un'applicazione può eseguire una query per ottenere le dimensioni del buffer di output necessarie 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.

Fabbisogno

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

Vedere anche

BAND_TABLE

ENUMERATE_BANDS_PARAMETERS