GET_BAND_METADATA_PARAMETERS struttura (ehstorbandmgmt.h)

Articolo
08/07/2023

I metadati per una banda configurata vengono recuperati in base ai parametri in una struttura GET_BAND_METADATA_PARAMETERS . Questa struttura è 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;

Members

StructSize

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

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.

MetadataOffset

Offset dall'inizio della proprietà dei metadati band da cui recuperare i dati.

MetadataSize

Lunghezza dei byte di metadati da recuperare.

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_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 equivale al valore in MetadataSize.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8
Intestazione	ehstorbandmgmt.h (include EhStorBandMgmt.h)

Vedi anche

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA

Condividi tramite