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) |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour