ERASE_BAND_PARAMETERS struttura (ehstorbandmgmt.h)

Articolo
03/05/2024

La struttura ERASE_BAND_PARAMETERS contiene i criteri di selezione per una banda da cancellare. È inoltre possibile impostare una nuova chiave di autenticazione. Questa struttura è input per una richiesta di IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .

Sintassi

typedef struct _ERASE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;

Members

StructSize

La dimensione di questa struttura in byte. Impostare su sizeof(ERASE_BAND_PARAMETERS).

Flags

Eliminare i flag di operazione. Questo valore è una combinazione OR bit per bit del seguente.

Valore	Significato
ERASEBAND_AUTHKEY_CACHING_ENABLED	La nuova chiave di autenticazione per questa banda viene memorizzata nella cache che consente l'automazione delle operazioni successive.

Reserved

Riservato.

BandId

Identificatore di una singola banda per restituire informazioni. BandSize deve essere 0 quando viene selezionata una singola band con BandId. Per usare BandStart e BandSize anziché BandId per selezionare una band, impostare BandId = (ULONG) -1.

BandStart

Percorso di byte iniziale nel dispositivo di archiviazione per avviare una ricerca band. Viene eseguito un tentativo di corrispondere a una band in o dopo BandStart.

NewAuthKeyOffset

Offset, in byte, di una struttura AUTH_KEY contenente la nuova chiave di autorizzazione per la banda. L'offset si trova dall'inizio di ERASE_BAND_PARAMETERS. AUTH_KEY viene dichiarato in ehstorbandmgmt.h come indicato di seguito.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

Dimensioni della chiave, in byte, dei dati delle chiavi in Chiave. Se KeySize è impostato su 0, viene usata una chiave predefinita.

Chiave

Matrice di byte a lunghezza variabile che contiene i dati chiave.

Per specificare una chiave di autenticazione predefinita sulla banda, impostare NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Commenti

La precedenza viene assegnata a BandID per la selezione di band. Se BandID è maggiore di 0 e BandID è minore del membro MaxBandCount di BAND_MANAGEMENT_CAPABILITIES, BandID viene usato come unico criterio di selezione per una corrispondenza band. Se BandID == -1, BandStart viene usato come criteri di corrispondenza per selezionare una band. Se nessuna banda corrisponde a uno dei criteri di selezione, STATUS_INVALID_PARAMETER viene restituito nel blocco IoStatus per IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.