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. Bandinformationen werden in einer Tabelle mit Bandeinträgen zurückgegeben, die Bandspeicherort und Sicherheitseigenschaften enthalten.
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 Größe des (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 Größe des Eingabepuffers ist ungültig. |
| STATUS_INVALID_PARAMETER | Die Informationen im Eingabepuffer sind ungültig. |
| STATUS_NOT_FOUND | Für die bereitgestellten Enumerationsparameter sind keine Bänder konfiguriert. |
| STATUS_BUFFER_OVERFLOW | Ein Puffer wird nicht bereitgestellt oder seine Größe auf Null festgelegt. Die erforderliche Größe wird im Feld Information zurückgegeben. |
| STATUS_IO_DEVICE_ERROR | Kommunikationsfehler. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel. |
| STATUS_BUFFER_TOO_SMALL | Der bereitgestellte Ausgabepuffer ist nicht groß genug, um die zurückgegebenen Ausgabedaten zu halten. |
Bemerkungen
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 mit dem Feld Status des IoStatus--Blocks zurückgegeben, der auf STATUS_BUFFER_OVERFLOW festgelegt ist, und das feld Information enthält die erforderliche Puffergröße.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Header- | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |
Siehe auch
ENUMERATE_BANDS_PARAMETERS