IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)

Il IOCTL_EHSTOR_BANDMGMT_ERASE_BAND richiedere la cancellazione crittografica e reimposta la chiave di autenticazione di una banda. La configurazione rimanente della banda viene lasciata non modificata.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il buffer di input in Irp-AssociatedIrp.SystemBuffer> deve contenere un ERASE_BAND_PARAMETERS e possibilmente una struttura AUTH_KEY.

Se il membro NewAuthKeyOffset 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 deve essere almeno sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY).

Buffer di output

Nessuno.

Lunghezza del buffer di output

Nessuno.

Input/Buffer di output

Nessuno.

Lunghezza del buffer di input/output

Nessuno.

Blocco dello stato

Uno dei valori seguenti può essere restituito nel campo Stato .

Valore stato	Descrizione
STATUS_SUCCESS	La band è stata cancellata correttamente.
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 band 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.

Commenti

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.

Nessun metodo viene fornito in Windows per modificare la chiave di autenticazione di cancellazione per un dispositivo di archiviazione. Se i parametri corretti vengono forniti come input nel buffer di sistema, questa richiesta deve essere completata. 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 band 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 per la lettura e la scrittura. I metadati di sicurezza impostati in precedenza vengono cancellati. La nuova chiave di autenticazione specificata in ERASE_BAND_PARAMETERS è impostata a meno che non venga indicato l'uso della chiave predefinita.

Per impedire ad altre applicazioni di controllare una banda e cancellare usando la chiave predefinita, è necessario includere una nuova chiave di autenticazione con la richiesta di IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .

Le modifiche apportate alla tabella band da questa richiesta vengono eseguite con il 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 su tutti i sistemi o gli errori di alimentazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Intestazione	ehstorbandmgmt.h (include EhStorBandMgmt.h)

Vedi anche

ERASE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS