IO_CSQ_INSERT_IRP_EX回调函数 (wdm.h)
CsqInsertIrpEx 例程由系统用来将 IRP 插入到实现的、取消安全的 IRP 队列中。
语法
IO_CSQ_INSERT_IRP_EX IoCsqInsertIrpEx;
NTSTATUS IoCsqInsertIrpEx(
[in] _IO_CSQ *Csq,
[in] PIRP Irp,
[in] PVOID InsertContext
)
{...}
参数
[in] Csq
指向取消安全 IRP 队列的 IO_CSQ 结构的指针。
[in] Irp
指向要插入 IRP 队列的 IRP 的指针。
[in] InsertContext
指向插入作的驱动程序定义的上下文的指针。
返回值
CsqInsertIrpEx 在成功插入 IRP 或失败时返回相应的错误代码STATUS_SUCCESS。
言论
驱动程序在初始化队列的 IO_CSQ 结构时,为取消安全的 IRP 队列指定 CsqInsertIrpEx 例程。 驱动程序将例程指定为初始化 IO_CSQ时 IoCsqInitializeEx 的 CsqInsertIrp 参数。 有关详细信息,请参阅 Cancel-Safe IRP 队列。
IoCsqInsertIrpEx 例程调用 CsqInsertIrpEx,以将 IRP 插入队列。 IoCsqInsertIrpEx 的 InsertContext 参数作为 CsqInsertIrpEx的 InsertContext 参数传递。
例子
若要定义 CsqInsertIrpEx 回调例程,必须首先提供一个函数声明来标识要定义的回调例程的类型。 Windows 为驱动程序提供一组回调函数类型。 使用回调函数类型声明函数有助于 驱动程序代码分析、静态驱动程序验证程序(SDV)和其他验证工具查找错误,这是为 Windows作系统编写驱动程序的要求。
例如,若要定义 CsqInsertIrpEx 名为 MyCsqInsertIrpEx
的回调例程,请使用IO_CSQ_INSERT_IRP_EX类型,如以下代码示例所示:
IO_CSQ_INSERT_IRP_EX MyCsqInsertIrpEx;
然后,按如下所示实现回调例程:
_Use_decl_annotations_
NTSTATUS
MyCsqInsertIrpEx(
struct _IO_CSQ *Csq,
PIRP Irp,
PVOID InsertContext
)
{
// Function body
}
IO_CSQ_INSERT_IRP_EX函数类型在 Wdm.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误,请务必将 _Use_decl_annotations_
注释添加到函数定义。
_Use_decl_annotations_
批注可确保使用应用于头文件中IO_CSQ_INSERT_IRP_EX函数类型的批注。 有关函数声明要求的详细信息,请参阅 使用 WDM 驱动程序的函数角色类型来声明函数。 有关 _Use_decl_annotations_
的信息,请参阅 批注函数行为。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |