ENUMERATE_BANDS_PARAMETERS Struktur (ehstorbandmgmt.h)
Die ENUMERATE_BANDS_PARAMETERS-Struktur wird verwendet, um auszuwählen, welche Bandinformationseinträge für die Rückgabe von einer IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS-Anforderung ausgewählt werden.
Syntax
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;
Member
StructSize
Die Größe dieser Struktur in Bytes. Legen Sie auf sizeof(ENUMERATE_BANDS_PARAMETERS) fest.
Flags
Bandaufzählungsflags. Dieser Wert ist eine bitweise OR-Kombination der folgenden.
| Wert | Bedeutung |
|---|---|
|
Alle Bänder werden zurückgegeben. Wenn dieses Flag festgelegt ist, werden die BandId-, BandStart- und BandSize-Member ignoriert. |
|
Schließen Sie Informationen zum Medienverschlüsselungsalgorithmus in das SecurityInfo-Element von BAND_TABLE_ENTRY ein. |
Reserved
Reserviert.
BandId
Der Bezeichner eines einzelnen Bandes, für das Informationen zurückgegeben werden sollen. BandSize muss 0 sein, wenn ein einzelnes Band mit BandId ausgewählt ist. Wenn Sie BandStart und BandSize anstelle von BandId verwenden möchten, um ein Band auszuwählen, legen Sie BandId = (ULONG) –1 fest.
BandStart
Der Startbytespeicherort auf dem Speichergerät, um eine Bandsuche zu starten. Es wird versucht, eine Band bei oder nach BandStart zuzuordnen.
BandSize
Ein optionaler Wert für die Bandgröße in Bytes. Wenn BandSize == 0 und BandId == –1 ist , ist BandStart der einzige Übereinstimmendwert für die Auswahl eines Bandes. Andernfalls wird eine Band bei oder nach BandStart und übereinstimmende BandSize genau ausgewählt.
Hinweise
Wenn ENUMBANDS_ENUM_ALL_BANDS nicht in Flags festgelegt ist, wird versucht, eine Auswahl zu einem einzelnen Band zu machen. Basierend auf den Werten in BandID, BandStart und BandSize wird eine einzelne Bandabgleichung vorgenommen. Die BandID für die Bandauswahl hat Vorrang. Wenn BandID> 0 und BandID<MaxBandCount-Mitglied von BAND_MANAGEMENT_CAPABILITIES Wenn BandID größer als 0 und BandID kleiner als das MaxBandCount-Mitglied von BAND_MANAGEMENT_CAPABILITIES ist, wird BandID als einziges Auswahlkriterium für eine Band-Übereinstimmung verwendet. Wenn BandID == –1, werden BandStart und BandSize als Übereinstimmungskriterien verwendet, um eine Band auszuwählen.
Wenn BandStart und BandSize zum Abgleichen eines Bandes verwendet werden, wird das erste Band zurückgegeben, das am oder nach dem BandStart-Speicherort konfiguriert ist und die genaue Größe von BandSize aufweist. Wenn BandSize == 0, wenn BandStart gültig ist, wird das erste Band, das bei oder nach BandStart konfiguriert ist, zurückgegeben.
Wenn BandID == 0 oder keine Bänder konfiguriert sind und Flags nicht auf ENUMBANDS_ENUM_ALL_BANDS festgelegt ist, wird das globale Band für das gesamte Gerät zurückgegeben.
BandStart und BandSize sind gültig, es sei denn, ihre Werte in Bytes sind exakte Vielfache der Sektorgröße des zugrunde liegenden Speichergeräts.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8 |
| Kopfzeile | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |