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
Keine.
Länge des Eingabepuffers
Keine.
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 0 (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. |
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_QUERY_CAPABILITIES-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 (include EhStorBandMgmt.h) |