IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)
La demande IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES récupère les fonctionnalités de sécurité groupées d’un périphérique de stockage. L’IOCTL retourne les fonctionnalités sous forme de structure BAND_MANAGEMENT_CAPABILITIES dans la mémoire tampon 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 dans 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 État .
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | L’appareil prend en charge la gestion des bandes et les fonctionnalités de sécurité sont retournées dans la mémoire tampon système. |
| STATUS_INVALID_DEVICE_REQUEST | La gestion des bandes n’est pas prise en charge sur le périphérique de stockage. |
| STATUS_INVALID_DEVICE_STATE | L’appareil prend en charge la gestion des bandes, 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 de la requête sur NULL et la taille de sortie sur 0. La demande IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES retourne avec le champ État du bloc IoStatus défini sur STATUS_BUFFER_OVERFLOW et le champ Informations contient la taille de mémoire tampon requise.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8 |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |