IoCsqInitialize 函数 (wdm.h)
IoCsqInitialize 例程初始化驱动程序的取消安全 IRP 队列调度表。
语法
NTSTATUS IoCsqInitialize(
[out] PIO_CSQ Csq,
[in] PIO_CSQ_INSERT_IRP CsqInsertIrp,
[in] PIO_CSQ_REMOVE_IRP CsqRemoveIrp,
[in] PIO_CSQ_PEEK_NEXT_IRP CsqPeekNextIrp,
[in] PIO_CSQ_ACQUIRE_LOCK CsqAcquireLock,
[in] PIO_CSQ_RELEASE_LOCK CsqReleaseLock,
[in] PIO_CSQ_COMPLETE_CANCELED_IRP CsqCompleteCanceledIrp
);
参数
[out] Csq
指向要由 IoCsqInitialize 初始化的IO_CSQ结构的指针。
[in] CsqInsertIrp
指向驱动程序取消安全 IRP 队列的驱动程序定义的 CsqInsertIrp 函数的指针。
[in] CsqRemoveIrp
指向驱动程序取消安全 IRP 队列的驱动程序定义的 CsqRemoveIrp 函数的指针。
[in] CsqPeekNextIrp
指向驱动程序取消安全 IRP 队列的驱动程序定义的 CsqPeekNextIrp 函数的指针。
[in] CsqAcquireLock
指向驱动程序取消安全 IRP 队列的驱动程序定义的 CsqAcquireLock 函数的指针。
[in] CsqReleaseLock
指向驱动程序取消安全 IRP 队列的驱动程序定义的 CsqReleaseLock 函数的指针。
[in] CsqCompleteCanceledIrp
指向驱动程序取消安全 IRP 队列的驱动程序定义的 CsqCompleteCanceledIrp 函数的指针。
返回值
此例程在成功时返回STATUS_SUCCESS，或在失败时返回相应的 NTSTATUS 错误代码。
注解
IoCsqInitialize 例程初始化描述驱动程序取消安全 IRP 队列的IO_CSQ结构。 驱动程序还可以使用 IoCsqInitializeEx 创建具有扩展功能的 IRP 队列。 有关详细信息，请参阅 取消安全 IRP 队列。
请注意， IoCsqXxx 例程使用 IRP 的 DriverContext[3] 成员来保存 IRP 上下文信息。 使用这些例程对 IRP 进行排队的驱动程序必须使该成员处于未使用状态。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows XP 和更高版本的 Windows 操作系统中可用。 还必须适用于 Windows 2000 和 Windows 98/Me 的驱动程序可以改为链接到 Csq.lib 以使用例程。 |
| 目标平台 | 通用 |
| 标头 | wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h） |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | 任何级别 |