PPARALLEL_TRY_ALLOCATE_ROUTINE回调函数（parallel.h）

项目
02/07/2025

PPARALLEL_TRY_ALLOCATE_ROUTINE类型化（ISR）回调例程尝试在 IRQL = DIRQL 处分配并行端口。并行端口的系统提供的函数驱动程序提供此例程。

语法

PPARALLEL_TRY_ALLOCATE_ROUTINE PparallelTryAllocateRoutine;

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

参数

[in] TryAllocateContext

指向表示并行端口的功能设备对象的设备扩展的指针。

返回值

返回代码	描述
TRUE	分配了并行端口。
FALSE	未分配并行端口。

言论

内核模式驱动程序使用 IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT连接中断服务例程，该例程返回 PARALLEL_INTERRUPT_INFORMATION 结构。此结构包括 TryAllocatePortAtInterruptLevel 成员，该成员是指向系统提供的 PPARALLEL_TRY_ALLOCATE_ROUTINE （ISR）回调的指针。

PPARALLEL_TRY_ALLOCATE_ROUTINE （ISR）回调是非阻止的，不对分配请求进行排队，并且会立即返回。

驱动程序将 PPARALLEL_TRY_ALLOCATE_ROUTINE （ISR）回调与驱动程序提供的 ISR 结合使用。如果在调用驱动程序的 ISR 时驱动程序没有分配并行端口，驱动程序可以使用此回调。

有关在 ISR 中分配并行端口的详细信息，请参阅将中断服务例程连接到 ParallelPort。

注释未测试 PPARALLEL_TRY_ALLOCATE_ROUTINE（ISR）回调。 Microsoft不建议使用客户端提供的中断例程。使用中断可能会导致系统不稳定。默认情况下，禁用 IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT 请求。