IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
I metadati associati a una banda vengono recuperati con una richiesta di IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA. I metadati per una banda fungono da area dati per un'applicazione di gestione delle chiavi.
Codice principale
Buffer di input
Il buffer di input in corrispondenza Irp->AssociatedIrp.SystemBuffer deve contenere una struttura GET_BAND_METADATA_PARAMETERS.
Lunghezza del buffer di input
Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer, che devono essere almeno sizeof (GET_BAND_METADATA_PARAMETERS).
Buffer di output
Il buffer di output in corrispondenza Irp->AssociatedIrp.SystemBuffer contiene una matrice di byte di metadati band specificati da GET_BAND_METADATA_PARAMETERS.
Lunghezza del buffer di output
Lunghezza di una struttura GET_BAND_METADATA_PARAMETERS.
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 | I metadati sono stati restituiti nel buffer di sistema. |
| STATUS_INVALID_DEVICE_REQUEST | Il dispositivo di archiviazione non supporta la gestione della banda. |
| STATUS_INVALID_BUFFER_SIZE | Le dimensioni del buffer di output non sono corrette. |
| STATUS_INVALID_PARAMETER | Le informazioni nel buffer di input non sono valide. |
| STATUS_NOT_FOUND | La banda non è stata trovata per i criteri di selezione specificati. |
| STATUS_IO_DEVICE_ERROR | Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza. |
Osservazioni
L'autenticazione per questo IOCTL non è necessaria e una chiave di autenticazione non è inclusa come input.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8 |
| intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |