PPARALLEL_TRY_ALLOCATE_ROUTINE función de devolución de llamada (parallel.h)

Artículo
02/07/2025

La rutina de devolución de llamada de PPARALLEL_TRY_ALLOCATE_ROUTINEcon tipo (ISR) intenta asignar un puerto paralelo en IRQL = DIRQL. El controlador de función proporcionado por el sistema para puertos paralelos proporciona esta rutina.

Sintaxis

PPARALLEL_TRY_ALLOCATE_ROUTINE PparallelTryAllocateRoutine;

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

Parámetros

[in] TryAllocateContext

Puntero a la extensión de dispositivo de un objeto de dispositivo funcional que representa un puerto paralelo.

Valor devuelto

Código devuelto	Descripción
TRUE	Se asignó el puerto paralelo.
FALSE	No se asignó el puerto paralelo.

Observaciones

Un controlador en modo kernel conecta una rutina de servicio de interrupción mediante un IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT, que devuelve una estructura de PARALLEL_INTERRUPT_INFORMATION. Esta estructura incluye el miembro TryAllocatePortAtInterruptLevel, que es un puntero a la devolución de llamada PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR) proporcionada por el sistema.

La devolución de llamada de PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR) no es de bloqueo, no pone en cola una solicitud de asignación y devuelve inmediatamente.

Un controlador usa la devolución de llamada de PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR) junto con un ISR proporcionado por el controlador. Si el controlador no tiene asignado un puerto paralelo cuando se llama al ISR del controlador, el controlador puede usar esta devolución de llamada.

Para obtener más información sobre cómo asignar un puerto paralelo en un ISR, vea Connecting an Interrupt Service Routine to a ParallelPort.

Nota No se prueba la devolución de llamada PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR). Microsoft no recomienda usar una rutina de interrupción proporcionada por el cliente. El uso de interrupciones puede provocar inestabilidad del sistema. De forma predeterminada, la solicitud IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT está deshabilitada.