Partager via


IOCTL_PAR_QUERY_RAW_DEVICE_ID IOCTL (ntddpar.h)

La requête IOCTL_PAR_QUERY_RAW_DEVICE_ID retourne un ID d’appareil brut, qui inclut le préfixe à deux octets qui spécifie la taille, en octets, de l’ID d’appareil IEEE 1284 de l’appareil ; l’ID d’appareil IEEE 1284 ; et un null terminateur.

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 un ID d’appareil brut. La mémoire tampon contient la séquence d’informations contiguë suivante : préfixe à deux octets qui spécifie la taille, en octets, de l’ID d’appareil IEEE 1284 de l’appareil ; l’ID de l’appareil ; et un null terminateur.

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 les éléments suivants : préfixe à deux octets qui spécifie la taille, en octets, de l’ID d’appareil IEEE 1284 de l’appareil ; l’ID de l’appareil ; et un null terminateur. Un ID d’appareil IEEE 1284 peut atteindre jusqu’à 64 Ko de taille.

Bloc d’état

Si la demande réussit, l'Informations membre est défini sur la taille, en octets, des informations retournées dans la mémoire tampon de sortie. 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, d’un préfixe à deux octets, de l’ID d’appareil IEEE 1284 et d’un null terminator.

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)

Voir aussi

IOCTL_PAR_QUERY_DEVICE_ID

IOCTL_PAR_QUERY_DEVICE_ID_SIZE