IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)
Il IOCTL_EHSTOR_BANDMGMT_ERASE_BAND richiedere la cancellazione crittografica e la reimpostazione della chiave di autenticazione di una banda. La configurazione rimanente della banda rimane invariata.
Codice principale
Buffer di input
Il buffer di input in corrispondenza Irp->AssociatedIrp.SystemBuffer deve contenere un ERASE_BAND_PARAMETERS ed eventualmente una struttura AUTH_KEY.
Se il NewAuthKeyOffset membro di ERASE_BAND_PARAMETERS è impostato su EHSTOR_BANDMGR_NO_KEY, i dati di input nel buffer di sistema non devono includere una struttura AUTH_KEY.
Lunghezza del buffer di input
Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer, che devono essere almeno sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY).
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Buffer di input/output
Nessuno.
Lunghezza del buffer di input/output
Nessuno.
Blocco di stato
È possibile restituire uno dei valori seguenti nel campo Stato.
| Valore di stato | Descrizione |
|---|---|
| STATUS_SUCCESS | La band è stata cancellata. |
| 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 corrette. |
| STATUS_INVALID_PARAMETER | Le informazioni nel buffer di input non sono valide. |
| STATUS_ACCESS_DENIED | La chiave di autenticazione di cancellazione non è una chiave predefinita e la banda non può essere cancellata. |
| 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
Una chiave di autenticazione di cancellazione corrente non viene fornita in una richiesta di IOCTL_EHSTOR_BANDMGMT_ERASE_BAND. La chiave di autenticazione di cancellazione per il dispositivo di archiviazione è configurata in precedenza.
In Windows non viene fornito alcun metodo per modificare la chiave di autenticazione di cancellazione per un dispositivo di archiviazione. A condizione che i parametri corretti vengano forniti come input nel buffer di sistema, questa richiesta deve avere esito positivo. Se la chiave di autenticazione di cancellazione è stata modificata all'esterno di Windows, ad esempio in un ambiente a doppio avvio con un sistema operativo diverso, questa richiesta potrebbe non riuscire.
Quando una banda viene cancellata con IOCTL_EHSTOR_BANDMGMT_ERASE_BAND, le uniche proprietà precedenti che rimangono sono le dimensioni della banda iniziale e della banda. La chiave di crittografia multimediale precedente viene rimossa e viene generata una nuova chiave. Il blocco è impostato su PERSISTANT_UNLOCK sia per la lettura che per la scrittura. I metadati di sicurezza impostati in precedenza vengono cancellati. La nuova chiave di autenticazione specificata in ERASE_BAND_PARAMETERS viene impostata a meno che non venga indicato l'uso della chiave predefinita.
Per impedire ad altre applicazioni di assumere il controllo di una banda e cancellare usando la chiave predefinita, è necessario includere una nuova chiave di autenticazione nella richiesta di IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.
Le modifiche apportate alla tabella band da questa richiesta vengono sottoposte al commit atomico del dispositivo prima del completamento della richiesta IOCTL. Pertanto, è garantito che la banda venga modificata con tutte le relative proprietà impostate o nessuna proprietà impostata in alcun caso in caso di errore di sistema o di alimentazione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8 |
| intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |