PPARALLEL_TRY_ALLOCATE_ROUTINE回调函数 (parallel.h)

项目
02/26/2024

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

语法

PPARALLEL_TRY_ALLOCATE_ROUTINE PparallelTryAllocateRoutine;

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

参数

[in] TryAllocateContext

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

返回值

返回代码	说明
TRUE	已分配并行端口。
FALSE	未分配并行端口。

注解

内核模式驱动程序使用返回PARALLEL_INTERRUPT_INFORMATION 结构的IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT连接中断服务例程。此结构包括 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 请求处于禁用状态。