IOCTL_CHANGER_GET_ELEMENT_STATUS IOCTL (ntddchgr.h)

Article
02/26/2024

Renvoie la status de tous les éléments ou la status d’un nombre spécifié d’éléments d’un type particulier.

Pour obtenir une description des types d’éléments possibles, consultez CHANGER_ELEMENT.

Code principal

Mémoire tampon d'entrée

La mémoire tampon dans Irp-AssociatedIrp.SystemBuffer> contient les données CHANGER_READ_ELEMENT_STATUS qui indiquent le type d’élément et le nombre d’éléments pour lesquels retourner status.

Si l’appelant définit le membre VolumeTagInfo de CHANGER_READ_ELEMENT_STATUS sur TRUE, l’élément status retourné inclut les informations de balise de volume.

Longueur de la mémoire tampon d’entrée

Parameters.DeviceIoControl.InputBufferLength dans l’emplacement de la pile d’E/S indique la taille, en octets, de la mémoire tampon de paramètre pour l’entrée, qui doit être >= sizeof(CHANGER_READ_ELEMENT_STATUS).

Mémoire tampon de sortie

Le pilote de miniclasse du changeur retourne l’élément changeur status données dans la mémoire tampon sur Irp-AssociatedIrp.SystemBuffer>. Certains éléments de type ChangerDrive retournent des données d’informations sur le produit. Si l’appareil fournit des informations sur le produit, le pilote de miniclasse signale l’élément status données dans une structure de type CHANGER_ELEMENT_STATUS_EX. Le pilote miniclasse définit ELEMENT_STATUS_PRODUCT_DATA dans le membre Indicateurs de la structure pour indiquer qu’il contient des données d’informations sur le produit. Pour les éléments de tous types autres que ChangerDrive, le pilote signale l’élément status données dans une structure de type CHANGER_ELEMENT_STATUS.

Longueur de la mémoire tampon de sortie

Parameters.DeviceIoControl.OutputBufferLength indique la taille, en octets, de la mémoire tampon de paramètre pour la sortie. Pour les éléments de type ChangerDrive, cette valeur doit être >= NumberOfElements * sizeof(CHANGER_ELEMENT_STATUS_EX). Pour les éléments de tous les autres types, cette valeur doit être >= NumberOfElements * sizeof(CHANGER_ELEMENT_STATUS).

Bloc d’état

Le champ Informations est défini sur le nombre d’octets retournés. Le champ État est défini sur STATUS_SUCCESS, ou éventuellement sur STATUS_BUFFER_TOO_SMALL, STATUS_INFO_LENGTH_MISMATCH, STATUS_INSUFFICIENT_RESOURCES, STATUS_INVALID_ELEMENT_ADDRESS ou STATUS_INVALID_PARAMETER.