IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Les métadonnées associées à une bande sont récupérées avec une requête IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA. Les métadonnées d’une bande servent de zone de données pour une application de gestionnaire de clés.
Code principal
Mémoire tampon d’entrée
La mémoire tampon d’entrée à Irp->AssociatedIrp.SystemBuffer doit contenir une structure GET_BAND_METADATA_PARAMETERS.
Longueur de la mémoire tampon d’entrée
Parameters.DeviceIoControl.InputBufferLength indique la taille, en octets, de la mémoire tampon, qui doit être au moins sizeof (GET_BAND_METADATA_PARAMETERS).
Mémoire tampon de sortie
La mémoire tampon de sortie à Irp->AssociatedIrp.SystemBuffer contient un tableau d’octets de métadonnées de bande spécifiées par GET_BAND_METADATA_PARAMETERS.
Longueur de la mémoire tampon de sortie
Longueur d’une structure GET_BAND_METADATA_PARAMETERS.
Bloc d’état
Le champ Informations contient le nombre d’octets retournés dans la mémoire tampon de sortie. L’une des valeurs suivantes peut être retournée dans le champ Status.
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | Les métadonnées ont été retournées dans la mémoire tampon système. |
| STATUS_INVALID_DEVICE_REQUEST | L’appareil de stockage ne prend pas en charge la gestion des bandes. |
| STATUS_INVALID_BUFFER_SIZE | La taille de la mémoire tampon de sortie est incorrecte. |
| STATUS_INVALID_PARAMETER | Les informations contenues dans la mémoire tampon d’entrée ne sont pas valides. |
| STATUS_NOT_FOUND | La bande n’a pas été trouvée pour les critères de sélection fournis. |
| STATUS_IO_DEVICE_ERROR | Échec de la communication. L’appareil de stockage peut être incompatible avec les protocoles de sécurité. |
Remarques
L’authentification pour cette IOCTL n’est pas nécessaire et une clé d’authentification n’est pas incluse comme entrée.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8 |
| d’en-tête | ehstorbandmgmt.h (include EhStorBandMgmt.h) |