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

Artigo
02/07/2025

A rotina de retorno de chamada ISR (tipada em PPARALLEL_TRY_ALLOCATE_ROUTINE) tenta alocar uma porta paralela em IRQL = DIRQL. O driver de funções fornecido pelo sistema para portas paralelas fornece essa rotina.

Sintaxe

PPARALLEL_TRY_ALLOCATE_ROUTINE PparallelTryAllocateRoutine;

BOOLEAN PparallelTryAllocateRoutine(
  [in] PVOID TryAllocateContext
)
{...}

Parâmetros

[in] TryAllocateContext

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

Valor de retorno

Código de retorno	Descrição
verdadeiro	A porta paralela foi alocada.
falso	A porta paralela não foi alocada.

Observações

Um driver no modo kernel conecta uma rotina de serviço de interrupção usando um IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT, que retorna uma estrutura PARALLEL_INTERRUPT_INFORMATION. Essa estrutura inclui o membro TryAllocatePortAtInterruptLevel, que é um ponteiro para o retorno de chamada isr (PPARALLEL_TRY_ALLOCATE_ROUTINE) fornecido pelo sistema.

O retorno de chamada do ISR (PPARALLEL_TRY_ALLOCATE_ROUTINE) não está sendo desbloqueado, não enfileira uma solicitação de alocação e retorna imediatamente.

Um driver usa o retorno de chamada isr (PPARALLEL_TRY_ALLOCATE_ROUTINE) em conjunto com um ISR fornecido pelo driver. Se o driver não tiver uma porta paralela alocada quando o ISR do driver for chamado, o driver poderá usar esse retorno de chamada.

Para obter mais informações sobre como alocar uma porta paralela em um ISR, consulte Conectando uma rotina de serviço de interrupção a umParallelPort.

Observação o retorno de chamada do PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR) não foi testado. A Microsoft não recomenda usar uma rotina de interrupção fornecida pelo cliente. O uso de interrupções pode causar instabilidade no sistema. Por padrão, a solicitação IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT está desabilitada.