IOCTL_PAR_QUERY_LOCATION IOCTL (ntddpar.h)
A solicitação IOCTL_PAR_QUERY_LOCATION retorna o nome de link simbólico "LPTn" ou "LPTn.m" associado a um dispositivo paralelo. Essa solicitação só tem suporte do Windows XP e posterior.
- Para obter mais informações, consulte pilhas de dispositivos para parallelports e dispositivos e interfaces de dispositivo paralelas, nomes internos e links simbólicos.
Código principal
Buffer de entrada
O cliente define o membro AssociatedIrp.SystemBuffer como um ponteiro para um buffer de caracteres para obter as informações de local.
Comprimento do buffer de entrada
O comprimento do buffer de caracteres.
Buffer de saída
O driver de barramento de porta paralela gera as informações de localização no buffer apontado por AssociatedIrp.SystemBuffer como uma cadeia de caracteres NULLterminada.
Comprimento do buffer de saída
O cliente define o membro Parameters.DeviceIoControl.OutputBufferLength ao comprimento do buffer de saída que o driver de ônibus fornecido pelo sistema para portas paralelas usa para gerar as informações de localização do dispositivo.
Bloco de status
Se a solicitação for bem-sucedida, o membro de Informações do será definido como o comprimento, em bytes, do nome do link simbólico mais o terminador de NULL. Caso contrário, de Informações está 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 o seguinte valor:
STATUS_BUFFER_TOO_SMALL
O membro Parameters.DeviceIoControl.OutputBufferLength é menor que o tamanho, em bytes, das informações de localização e do terminador de NULL.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ntddpar.h (inclua Ntddpar.h) |