struttura GET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)
I metadati per una banda configurata vengono recuperati in base ai parametri in una struttura GET_BAND_METADATA_PARAMETERS. Questa struttura è l'input per una richiesta di IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA.
Sintassi
typedef struct _GET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
} GET_BAND_METADATA_PARAMETERS, *PGET_BAND_METADATA_PARAMETERS;
Membri
StructSize
Dimensione di questa struttura in byte. Impostare su sizeof(GET_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 da cui recuperare i dati.
MetadataSize
Lunghezza dei byte di metadati da recuperare.
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 restituita nel blocco IoStatus per IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA.
Se BandID e BandStart sono entrambi impostati su -1, il IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA restituisce i metadati per la banda globale.
Se IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA ha avuto esito positivo, Parameters.DeviceIoControl.InputBufferLength è uguale al valore in MetadataSize.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8 |
| intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |