IOCTL_PAR_QUERY_DEVICE_ID IOCTL (ntddpar.h)

La requête IOCTL_PAR_QUERY_DEVICE_ID retourne l’ID de périphérique IEEE 1284 d’un appareil parallèle attribué par le pilote de fonction fourni par le système pour les ports parallèles.

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

Le membre AssociatedIrp.SystemBuffer pointe vers une mémoire tampon que le client alloue pour générer l’ID de l’appareil. La mémoire tampon contient l’ID de l’appareil et un point de terminaison NULL .

Longueur de la mémoire tampon de sortie

Le membre Parameters.DeviceIoControl.OutputBufferLength spécifie la taille, en octets, de la mémoire tampon de sortie qui peut contenir à la fois l’ID de l’appareil et une terminaison NULL . Un client peut utiliser une demande de IOCTL_PAR_QUERY_DEVICE_ID_SIZE pour déterminer la taille de mémoire tampon requise. La taille d’un ID d’appareil peut atteindre 64 Ko.

Bloc d’état

Si la demande réussit, le membre Information est défini sur la taille, en octets, d’une mémoire tampon qui contient à la fois l’ID de l’appareil et un point de terminaison NULL . Sinon, le membre Information est défini sur zéro.

Le membre Status est défini sur l’une des valeurs génériques status retournées par les demandes de contrôle d’appareil pour les appareils parallèles ou sur l’une des valeurs suivantes :

STATUS_BUFFER_TOO_SMALL

La mémoire tampon de sortie vers laquelle AssociatedIrp.SystemBuffer pointe est inférieure à la taille, en octets, de l’ID de l’appareil et d’un point de terminaison NULL .

STATUS_IO_DEVICE_ERROR

Une erreur d’E/S d’appareil s’est produite.

Configuration requise

Voir aussi

IOCTL_PAR_QUERY_DEVICE_ID_SIZE