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 Schlüssel-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 Größe der (GET_BAND_METADATA_PARAMETERS) sein muss.
Ausgabepuffer
Der Ausgabepuffer bei Irp->AssociatedIrp.SystemBuffer enthält ein Bytearray von Bandmetadaten, die durch GET_BAND_METADATA_PARAMETERSangegeben werden.
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 | Kommunikationsfehler. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel. |
Bemerkungen
Die Authentifizierung für diese IOCTL ist nicht erforderlich, und ein Authentifizierungsschlüssel ist nicht als Eingabe enthalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8 |
| Header- | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |