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

指向驱动程序定义的 CsqInsertIrp 函数的指针,用于驱动程序的取消安全 IRP 队列。

[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 任何级别

另请参阅

CsqAcquireLock

CsqCompleteCanceledIrp

CsqInsertIrp

CsqInsertIrpEx

CsqPeekNextIrp

CsqReleaseLock

CsqRemoveIrp

IO_CSQ

IoCsqInitializeEx

IoCsqInsertIrp

IoCsqInsertIrpEx

IoCsqRemoveIrp

IoCsqRemoveNextIrp