KeInsertQueue 函数 (ntifs.h)
KeInsertQueue 例程在给定队列的末尾插入一个条目，如果它不能立即使用该条目来满足线程等待。
语法
LONG KeInsertQueue(
[in, out] PRKQUEUE Queue,
[in, out] PLIST_ENTRY Entry
);
参数
[in, out] Queue
指向初始化的队列对象的指针，调用方为其在非分页池中提供常驻存储。
[in, out] Entry
指向要排队的条目的指针。 此指针必须是常驻系统空间地址。
返回值
KeInsertQueue 返回给定 队列的上一个信号状态。 如果它设置为零， (即在调用 KeInsertQueue 之前未) 发出信号， 则 KeInsertQueue 返回零，这意味着没有排队的条目。 如果是非零 () 发出信号， 则 KeInsertQueue 返回在调用 KeInsertQueue 之前排队的条目数。
注解
KeInsertQueue 排队的条目必须从非分页池中分配。 例如，可以使用 ExAllocatePoolWithTag 分配调用方定义的条目的内存。 如果调用方分配固定大小的条目，则使用 ExInitializeNPagedLookasideList 创建 lookaside 列表并使用 ExAllocateFromNPagedLookasideList 从该列表进行分配比频繁调用 ExAllocatePoolWithTag 更高效，尤其是对于大小不是PAGE_SIZE倍数的条目。
如果在调用 KeInsertQueue 时，任何线程都在队列对象上等待，则此调用满足单个线程的等待。 使用给定 的 Entry 指针调度线程以执行。
如果在调用 KeInsertQueue 时当前没有线程在队列对象上等待，则会在队列中插入给定条目，并且队列对象的信号状态会递增。
有关使用驱动程序管理的内部队列的详细信息，请参阅 驱动程序托管队列。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 标头 | ntifs.h (包括 Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | HwStorPortProhibitedDDI (storport) |
另请参阅
ExAllocateFromNPagedLookasideList