Condividi tramite


IOCTL_PAR_QUERY_DEVICE_ID IOCTL (ntddpar.h)

La richiesta IOCTL_PAR_QUERY_DEVICE_ID restituisce l'ID dispositivo IEEE 1284 di un dispositivo parallelo assegnato dal driver di funzione fornito dal sistema per le porte parallele.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno.

Lunghezza del buffer di input

Nessuno.

Buffer di output

Il AssociatedIrp.SystemBuffer punta a un buffer allocato dal client per l'output dell'ID dispositivo. Il buffer contiene l'ID dispositivo e un null terminatore.

Lunghezza del buffer di output

Il membro Parameters.DeviceIoControl.OutputBufferLength specifica le dimensioni, in byte, del buffer di output che può contenere sia l'ID del dispositivo che un terminatore NULL. Un client può usare una richiesta di IOCTL_PAR_QUERY_DEVICE_ID_SIZE per determinare le dimensioni del buffer necessarie. Un ID dispositivo può avere dimensioni fino a 64 KB.

Blocco di stato

Se la richiesta ha esito positivo, il membro informazioni viene impostato sulle dimensioni, in byte, di un buffer che contiene sia l'ID dispositivo che un NULL terminatore. In caso contrario, il membro Informazioni è impostato su zero.

Il membro stato è impostato su uno dei valori di stato generici restituiti dalle richieste di controllo del dispositivo per i dispositivi paralleli o su uno dei valori seguenti:

STATUS_BUFFER_TOO_SMALL

Il buffer di output che AssociatedIrp.SystemBuffer punta a è minore delle dimensioni, in byte, dell'ID dispositivo e di un null terminatore.

STATUS_IO_DEVICE_ERROR

Si è verificato un errore di I/O del dispositivo.

Fabbisogno

Requisito Valore
intestazione ntddpar.h (include Ntddpar.h)

Vedere anche

IOCTL_PAR_QUERY_DEVICE_ID_SIZE