IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)
Die IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES Anforderung ruft die gebänderten Sicherheitsfunktionen für ein Speichergerät ab. Die IOCTL gibt die Funktionen als BAND_MANAGEMENT_CAPABILITIES Struktur im Systempuffer zurück.
Hauptcode
Eingabepuffer
Nichts.
Eingabepufferlänge
Nichts.
Ausgabepuffer
Der Ausgabepuffer bei Irp->AssociatedIrp.SystemBuffer enthält eine BAND_MANAGEMENT_CAPABILITIES Struktur.
Länge des Ausgabepuffers
Die Länge einer BAND_MANAGEMENT_CAPABILITIES Struktur.
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 | Das Gerät unterstützt die Bandverwaltung, und die Sicherheitsfunktionen werden im Systempuffer zurückgegeben. |
| STATUS_INVALID_DEVICE_REQUEST | Die Bandverwaltung wird auf dem Speichergerät nicht unterstützt. |
| STATUS_INVALID_DEVICE_STATE | Das Gerät bietet Unterstützung für die Bandverwaltung, aber nicht in seiner aktuellen Konfiguration. |
| STATUS_BUFFER_OVERFLOW | Ein Puffer wird nicht bereitgestellt, oder seine Größe ist auf Null festgelegt. Die erforderliche Größe wird im Feld Information zurückgegeben. |
| STATUS_BUFFER_TOO_SMALL | Die Puffergröße ist zu klein, um die Ausgabe zurückzugeben. |
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_QUERY_CAPABILITIES Anforderung wird mit dem Feld Status Feld 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) |