struttura SET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)

Articolo
02/06/2025

I metadati per una banda configurata vengono impostati sui parametri in una struttura SET_BAND_METADATA_PARAMETERS. Questa struttura è l'input per una richiesta di IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA.

Sintassi

typedef struct _SET_BAND_METADATA_PARAMETERS {
  ULONG         StructSize;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         MetadataOffset;
  ULONG         MetadataSize;
  ULONG         BufferOffset;
  ULONG         AuthKeyOffset;
} SET_BAND_METADATA_PARAMETERS, *PSET_BAND_METADATA_PARAMETERS;

Membri

StructSize

Dimensione di questa struttura in byte. Impostare su sizeof(SET_BAND_METADATA_PARAMETERS).

BandId

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

BandStart

Posizione dei byte iniziale nel dispositivo di archiviazione per avviare una ricerca di band. Viene effettuato un tentativo di trovare una corrispondenza con una banda in o dopo BandStart.

MetadataOffset

Offset dall'inizio della proprietà dei metadati della banda per impostare i nuovi dati.

MetadataSize

Lunghezza dei byte di metadati da impostare. Questa dimensione è limitata dal valore di MetadataOffset sottratto dal membro BandMetadataSize della struttura BAND_MANAGEMENT_CAPABILITIES.

BufferOffset

Offset, in byte, dall'inizio di SET_BAND_METADATA_PARAMETERS alla posizione dei nuovi metadati.

AuthKeyOffset

Offset, in byte, di una struttura AUTH_KEY contenente la chiave di autorizzazione per la banda. L'offset è dall'inizio di SET_BAND_METADATA_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 della chiave 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 per la banda, impostare AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Osservazioni

La precedenza viene assegnata a BandID per la selezione della banda. 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 di banda. Se BandID == -1, BandStart viene usato come criterio di corrispondenza per selezionare una banda. Se nessuna banda corrisponde a uno dei criteri di selezione, STATUS_INVALID_PARAMETER viene restituito nel blocco IoStatus per IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA.

Se BandID e BandStart sono entrambi impostati su -1, il IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA imposta i metadati per la banda globale.

Le dimensioni dell'archivio dei metadati della banda si trovano nel membro BandMetadataSize di BAND_MANAGEMENT_CAPABILITIES. Questa struttura viene restituita da una richiesta di IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES.

I nuovi metadati da impostare per la banda sono inclusi nel buffer di sistema per la richiesta di IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA e seguono questa struttura in BufferOffset.