PPARALLEL_QUERY_WAITERS_ROUTINE função de retorno de chamada (parallel.h)

Artigo
02/27/2024

A rotina de retorno de chamada com tipo PPARALLEL_QUERY_WAITERS_ROUTINE retorna o número de solicitações de IOCTL_INTERNAL_PARALLEL_PORT_ALLOCATE e IOCTL_INTERNAL_SELECT_DEVICE enfileiradas na fila de trabalho de uma porta paralela. O driver de função fornecido pelo sistema para portas paralelas fornece essa rotina.

Sintaxe

PPARALLEL_QUERY_WAITERS_ROUTINE PparallelQueryWaitersRoutine;

ULONG PparallelQueryWaitersRoutine(
  [in] PVOID QueryAllocsContext
)
{...}

Parâmetros

[in] QueryAllocsContext

Ponteiro para a extensão de dispositivo de um FDO (objeto de dispositivo funcional) que representa uma porta paralela.

Retornar valor

O número de solicitações enfileiradas na fila de trabalho da porta paralela.

Comentários

Para obter um ponteiro para o retorno de chamada PPARALLEL_QUERY_WAITERS_ROUTINE fornecido pelo sistema, um driver de modo kernel usa uma solicitação de IOCTL_INTERNAL_GET_PARALLEL_PORT_INFO , que retorna uma estrutura PARALLEL_PORT_INFORMATION . O membro QueryNumWaiters da estrutura PARALLEL_PORT_INFORMATION é um ponteiro para esse retorno de chamada.

Um driver pode usar o retorno de chamada PPARALLEL_QUERY_WAITERS_ROUTINE para ajustar o uso da porta paralela com base no número de outros clientes que estão aguardando acesso à porta paralela. O driver de função fornecido pelo sistema para filas de portas paralelas aloca apenas e seleciona solicitações.

Para obter mais informações, confira Sincronizando o uso de um ParallelPort.