IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)
La requête IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES récupère les fonctionnalités de sécurité en bande pour un appareil de stockage. Le IOCTL retourne les fonctionnalités sous la forme d’une structure BAND_MANAGEMENT_CAPABILITIES dans la mémoire tampon du système.
Code principal
Mémoire tampon d’entrée
Aucun.
Longueur de la mémoire tampon d’entrée
Aucun.
Mémoire tampon de sortie
La mémoire tampon de sortie à Irp->AssociatedIrp.SystemBuffer contient une structure BAND_MANAGEMENT_CAPABILITIES.
Longueur de la mémoire tampon de sortie
Longueur d’une structure BAND_MANAGEMENT_CAPABILITIES.
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 | L’appareil prend en charge la gestion de bande et les fonctionnalités de sécurité sont retournées dans la mémoire tampon système. |
| STATUS_INVALID_DEVICE_REQUEST | La gestion de bande n’est pas prise en charge sur l’appareil de stockage. |
| STATUS_INVALID_DEVICE_STATE | L’appareil fournit une prise en charge de la gestion de bande, mais pas dans sa configuration actuelle. |
| STATUS_BUFFER_OVERFLOW | Une mémoire tampon n’est pas fournie ou sa taille est définie sur zéro. La taille requise est retournée dans le champ Informations. |
| STATUS_BUFFER_TOO_SMALL | La taille de la mémoire tampon est trop petite pour retourner la sortie. |
Remarques
Un pilote ou une application peut interroger la taille de mémoire tampon de sortie nécessaire en définissant la mémoire tampon de sortie pour la requête sur NULL et la taille de sortie sur 0. La demande de IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES retourne avec le champ Status du bloc IoStatus défini sur STATUS_BUFFER_OVERFLOW et le champ Information contiendra la taille de mémoire tampon requise.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8 |
| d’en-tête | ehstorbandmgmt.h (include EhStorBandMgmt.h) |