Partager via


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

IRP_MJ_DEVICE_CONTROL

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)

Voir aussi

BAND_MANAGEMENT_CAPABILITIES