IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)

  • Articolo

La richiesta di IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES recupera le funzionalità di sicurezza con banda per un dispositivo di archiviazione. IOCTL restituisce le funzionalità come struttura BAND_MANAGEMENT_CAPABILITIES nel buffer di sistema.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno.

Lunghezza del buffer di input

Nessuno.

Buffer di output

Il buffer di output in Irp-AssociatedIrp.SystemBuffer> contiene una struttura BAND_MANAGEMENT_CAPABILITIES.

Lunghezza del buffer di output

Lunghezza di una struttura BAND_MANAGEMENT_CAPABILITIES .

Blocco dello 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 Il dispositivo supporta la gestione banda e le funzionalità di sicurezza vengono restituite nel buffer di sistema.
STATUS_INVALID_DEVICE_REQUEST La gestione della banda non è supportata nel dispositivo di archiviazione.
STATUS_INVALID_DEVICE_STATE Il dispositivo fornisce supporto per la gestione della banda, ma non nella configurazione attuale.
STATUS_BUFFER_OVERFLOW Un buffer non viene fornito o le relative dimensioni sono impostate su zero. Le dimensioni necessarie vengono restituite nel campo Informazioni .
STATUS_BUFFER_TOO_SMALL La dimensione del buffer è troppo piccola per restituire l'output.

Commenti

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_QUERY_CAPABILITIES 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_MANAGEMENT_CAPABILITIES