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 |
---|---|
|
Vengono restituite tutte le bande. Quando questo flag è impostato, i membri BandId, BandStarte Membri BandSize. |
|
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) |