IOCTL_PAR_QUERY_DEVICE_ID IOCTL (ntddpar.h)
La requête IOCTL_PAR_QUERY_DEVICE_ID retourne l’ID d’appareil IEEE 1284 d’un appareil parallèle affecté par le pilote de fonction fourni par le système pour les ports parallèles.
Code principal
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 d’appareil. La mémoire tampon contient l’ID d’appareil et un de fin de 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 d’appareil et un null terminator. Un client peut utiliser une demande de IOCTL_PAR_QUERY_DEVICE_ID_SIZE pour déterminer la taille de mémoire tampon requise. Un ID d’appareil peut atteindre jusqu’à 64 Ko de taille.
Bloc d’état
Si la requête réussit, l'Informations membre est défini sur la taille, en octets, d’une mémoire tampon qui contient à la fois l’ID de l’appareil et un null terminateur. Dans le cas contraire, le membre Information est défini sur zéro.
Le membre Status est défini sur l’une des valeurs d’état génériques retournées par les demandes de contrôle d’appareil pour les appareils parallèles ou l’une des valeurs suivantes :
STATUS_BUFFER_TOO_SMALL
La mémoire tampon de sortie à laquelle AssociatedIrp.SystemBuffer points est inférieure à la taille, en octets, de l’ID d’appareil et d’un null terminateur.
STATUS_IO_DEVICE_ERROR
Une erreur d’E/S d’appareil s’est produite.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddpar.h (include Ntddpar.h) |