IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)
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
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) |