IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS IOCTL (ehstorbandmgmt.h)
Diese IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS Anforderung wird gesendet, um die Liste der Bänder für ein Speichergerät unter Bandverwaltung abzurufen. Bandinginformationen werden in einer Tabelle mit Bandeinträgen zurückgegeben, die Bandspeicherort und Sicherheitseigenschaften enthält.
Hauptcode
Eingabepuffer
Der Puffer bei Irp-AssociatedIrp.SystemBuffer> muss eine ENUMERATE_BANDS_PARAMETERS-Struktur enthalten.
Eingabepufferlänge
Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Puffers in Bytes an, die mindestens sizeof (ENUMERATE_BANDS_PARAMETERS) sein muss.
Ausgabepuffer
Der Puffer bei Irp-AssociatedIrp.SystemBuffer> enthält eine BAND_TABLE-Struktur gefolgt von BandTableEntryCount-Bandeinträgen.
Länge des Ausgabepuffers
Die Länge einer BAND_TABLE-Struktur gefolgt von BandTableEntryCount-Bandeinträgen .
Statusblock
Das Feld Information enthält die Anzahl der im Ausgabepuffer zurückgegebenen Bytes. Einer der folgenden Werte kann im Feld Status zurückgegeben werden.
| Statuswert | BESCHREIBUNG |
|---|---|
| STATUS_SUCCESS | Sicherheitsfeatures auf dem Speichergerät wurden deaktiviert. |
| STATUS_INVALID_DEVICE_REQUEST | Das Speichergerät unterstützt keine Bandverwaltung. |
| STATUS_INVALID_BUFFER_SIZE | Die Eingabepuffergröße ist ungültig. |
| STATUS_INVALID_PARAMETER | Die Informationen im Eingabepuffer sind ungültig. |
| STATUS_NOT_FOUND | Für die angegebenen Enumerationsparameter sind keine Bänder konfiguriert. |
| STATUS_BUFFER_OVERFLOW | Ein Puffer wird nicht bereitgestellt oder seine Größe auf 0 festgelegt. Die erforderliche Größe wird im Feld Information zurückgegeben. |
| STATUS_IO_DEVICE_ERROR | Fehler bei der Kommunikation. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel. |
| STATUS_BUFFER_TOO_SMALL | Der angegebene Ausgabepuffer ist nicht groß genug, um die zurückgegebenen Ausgabedaten aufzunehmen. |
Hinweise
Ein Treiber oder eine Anwendung kann die erforderliche Ausgabepuffergröße abfragen, indem der Ausgabepuffer für die Anforderung auf NULL und die Ausgabegröße auf 0 festgelegt wird. Die IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS Anforderung wird zurückgegeben, wobei das Feld Status des IoStatus-Blocks auf STATUS_BUFFER_OVERFLOW festgelegt ist, und das Feld Information enthält die erforderliche Puffergröße.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8. |
| Kopfzeile | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |
Weitere Informationen
ENUMERATE_BANDS_PARAMETERS