IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Metadaten, die einem Band zugeordnet sind, werden mit einer IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA Anforderung abgerufen. Die Metadaten für ein Band dienen als Datenbereich für eine Key Manager-Anwendung.
Hauptcode
Eingabepuffer
Der Eingabepuffer bei Irp-AssociatedIrp.SystemBuffer> muss eine GET_BAND_METADATA_PARAMETERS-Struktur enthalten.
Eingabepufferlänge
Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Puffers in Bytes an, die mindestens sizeof (GET_BAND_METADATA_PARAMETERS) sein muss.
Ausgabepuffer
Der Ausgabepuffer bei Irp-AssociatedIrp.SystemBuffer> enthält ein Bytearray von Bandmetadaten, das von GET_BAND_METADATA_PARAMETERS angegeben wird.
Länge des Ausgabepuffers
Die Länge einer GET_BAND_METADATA_PARAMETERS-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 | Die Metadaten wurden im Systempuffer zurückgegeben. |
| STATUS_INVALID_DEVICE_REQUEST | Das Speichergerät unterstützt keine Bandverwaltung. |
| STATUS_INVALID_BUFFER_SIZE | Die Ausgabepuffergröße ist falsch. |
| STATUS_INVALID_PARAMETER | Die Informationen im Eingabepuffer sind ungültig. |
| STATUS_NOT_FOUND | Das Band wurde für die angegebenen Auswahlkriterien nicht gefunden. |
| STATUS_IO_DEVICE_ERROR | Fehler bei der Kommunikation. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel. |
Hinweise
Die Authentifizierung für diese IOCTL ist nicht erforderlich, und ein Authentifizierungsschlüssel ist nicht als Eingabe enthalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8 |
| Kopfzeile | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |