Compartilhar via


IOCTL_PAR_QUERY_DEVICE_ID IOCTL (ntddpar.h)

A solicitação IOCTL_PAR_QUERY_DEVICE_ID retorna a ID do dispositivo IEEE 1284 de um dispositivo paralelo atribuído pelo driver de função fornecido pelo sistema para portas paralelas.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Comprimento do buffer de entrada

Nenhum.

Buffer de saída

O membro AssociatedIrp.SystemBuffer aponta para um buffer que o cliente aloca para gerar a ID do dispositivo. O buffer contém a ID do dispositivo e um terminador NULL .

Comprimento do buffer de saída

O membro Parameters.DeviceIoControl.OutputBufferLength especifica o tamanho, em bytes, do buffer de saída que pode conter a ID do dispositivo e um terminador NULL . Um cliente pode usar uma solicitação IOCTL_PAR_QUERY_DEVICE_ID_SIZE para determinar o tamanho do buffer necessário. Uma ID do dispositivo pode ter até 64 KB de tamanho.

Bloco de status

Se a solicitação for bem-sucedida, o membro Informações será definido como o tamanho, em bytes, de um buffer que contém a ID do dispositivo e um terminador NULL . Caso contrário, o membro Informações será definido como zero.

O membro Status é definido como um dos valores de status genéricos retornados por solicitações de controle de dispositivo para dispositivos paralelos ou para um dos seguintes valores:

STATUS_BUFFER_TOO_SMALL

O buffer de saída para o qual AssociatedIrp.SystemBuffer aponta é menor que o tamanho, em bytes, da ID do dispositivo e de um terminador NULL .

STATUS_IO_DEVICE_ERROR

Ocorreu um erro de E/S do dispositivo.

Requisitos

Requisito Valor
Cabeçalho ntddpar.h (inclua Ntddpar.h)

Confira também

IOCTL_PAR_QUERY_DEVICE_ID_SIZE