ENUMERATE_BANDS_PARAMETERS Struktur (ehstorbandmgmt.h)
Die ENUMERATE_BANDS_PARAMETERS Struktur wird verwendet, um auszuwählen, welche Bandinformationseinträge für die Rückgabe aus 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;
Angehörige
StructSize
Die Größe dieser Struktur in Byte. Auf Größe(ENUMERATE_BANDS_PARAMETERS) festgelegt.
Flags
Bandenenumerationskennzeichnungen. Dieser Wert ist eine bitweise OR-Kombination aus dem folgenden.
| Wert | Bedeutung |
|---|---|
|
Alle Bänder werden zurückgegeben. Wenn dieses Kennzeichen festgelegt ist, werden die BandId-, BandStart-und BandSize-Member ignoriert. |
|
Fügen Sie Informationen zum Medienverschlüsselungsalgorithmus in das SecurityInfo Mitglied von BAND_TABLE_ENTRYein. |
Reserved
Reserviert.
BandId
Der Bezeichner eines einzelnen Bandes, für den Informationen zurückgegeben werden sollen. BandSize- muss 0 sein, wenn ein einzelnes Band mit BandId ausgewählt wird. Um BandStart- und BandSize anstelle BandId- zum Auswählen eines Bandes zu verwenden, legen Sie BandId = (ULONG) –1 fest.
BandStart
Der Startbytespeicherort auf dem Speichergerät, um eine Bandsuche zu starten. Es wird versucht, ein Band an oder nach BandStart-abzugleichen.
BandSize
Ein optionaler Wert für die Bandgröße in Byte. Wenn BandSize == 0 und BandId == –1, ist BandStart- der einzige Übereinstimmungswert für die Auswahl eines Bandes. Andernfalls wird ein Band bei oder nach BandStart- und übereinstimmenden BandSize- genau ausgewählt.
Bemerkungen
Wenn ENUMBANDS_ENUM_ALL_BANDS nicht in Flagsfestgelegt ist, wird ein Auswahlversuch unternommen, um einem einzelnen Band zu entsprechen. Basierend auf den Werten in BandID, BandStart-und BandSizewird eine einzelne Bandabgleichung vorgenommen. Rangfolge wird BandID- für die Bandauswahl zugewiesen. Wenn BandID> 0 und BandID<MaxBandCount Mitglied von BAND_MANAGEMENT_CAPABILITIES Wenn BandID größer als 0 ist und BandID- kleiner als das MaxBandCount Mitglied der BAND_MANAGEMENT_CAPABILITIESist, wird BandID- als einzige Auswahlkriterien für eine Band-Übereinstimmung verwendet. Wenn BandID == –1, werden BandStart und BandSize- als Übereinstimmungskriterien zum Auswählen eines Bandes verwendet.
Wenn BandStart und BandSize- verwendet werden, wird das erste bei oder nach dem BandStart Speicherort mit der genauen Größe von BandSize zurückgegeben. Wenn BandSize == 0 ist, wenn BandStart- gültig ist, wird das erste bei oder nach BandStart 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 ungültig, es sei denn, ihre Werte in Bytes sind genaue Vielfache der Sektorgröße des zugrunde liegenden Speichergeräts.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8 |
| Header- | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |