IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Les métadonnées associées à une bande sont récupérées avec une demande 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 sur 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 sur 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 État .
| 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 | Le périphérique 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. Le périphérique de stockage peut être incompatible avec les protocoles de sécurité. |
Remarques
L’authentification pour ce IOCTL n’est pas nécessaire et une clé d’authentification n’est pas incluse comme entrée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8 |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |