Condividi tramite


struttura ENUMERATE_BANDS_PARAMETERS (ehstorbandmgmt.h)

La struttura ENUMERATE_BANDS_PARAMETERS viene utilizzata per selezionare le voci di informazioni sulla banda selezionate per la restituzione da una richiesta di IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS.

Sintassi

typedef struct _ENUMERATE_BANDS_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  LARGE_INTEGER BandSize;
} ENUMERATE_BANDS_PARAMETERS, *PENUMERATE_BANDS_PARAMETERS;

Membri

StructSize

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

Flags

Flag di enumerazione banda. Questo valore è una combinazione OR bit per bit di quanto segue.

Valore Significato
ENUMBANDS_ENUM_ALL_BANDS
Vengono restituite tutte le bande. Quando questo flag è impostato, i membri BandId, BandStarte Membri BandSize.
ENUMBANDS_REPORT_CRYPTO_ALGO
Includere le informazioni sull'algoritmo di crittografia multimediale nel membro SecurityInfo di BAND_TABLE_ENTRY.

Reserved

Riservato.

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.

BandSize

Valore di corrispondenza facoltativo per le dimensioni della banda in byte. Se BandSize == 0 e BandId == –1, BandStart è l'unico valore di corrispondenza per la selezione di una banda. In caso contrario, viene selezionata esattamente una banda all'indirizzo o dopo BandStart e la corrispondenza BandSize.

Osservazioni

Quando ENUMBANDS_ENUM_ALL_BANDS non è impostato in Flag, viene effettuato un tentativo di selezione per trovare una corrispondenza con una singola banda. Viene eseguita una corrispondenza a banda singola in base ai valori in BandID, BandStarte BandSize. La precedenza viene assegnata a BandID per la selezione della banda. Se BandID> 0 e BandID<membro MaxBandCount di BAND_MANAGEMENT_CAPABILITIES If 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 e BandSize vengono usati come criteri di corrispondenza per selezionare una banda.

Quando BandStart e BandSize vengono usati per trovare una corrispondenza con una band, viene restituita la prima banda configurata in corrispondenza o dopo la posizione BandStart con le dimensioni esatte di BandSize. Se BandSize == 0, quando BandStart è valido, viene restituita la prima banda configurata in corrispondenza o dopo BandStart.

Se BandID == 0 o non sono configurate bande e flag non è impostato su ENUMBANDS_ENUM_ALL_BANDS, viene restituita la banda globale per l'intero dispositivo.

BandStart e BandSize non sono validi a meno che i relativi valori, in byte, non siano multipli esatti delle dimensioni del settore del dispositivo di archiviazione sottostante.

Fabbisogno

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

Vedere anche

BAND_MANAGEMENT_CAPABILITIES

BAND_TABLE

BAND_TABLE_ENTRY

IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS