KeInsertByKeyDeviceQueue 函式 (wdm.h)
KeInsertByKeyDeviceQueue 例程會取得指定 DeviceQueue 的微調鎖定，並在裝置佇列設定為忙碌狀態時，根據指定的排序索引鍵值排入佇列。
語法
BOOLEAN KeInsertByKeyDeviceQueue(
[in, out] PKDEVICE_QUEUE DeviceQueue,
[in, out] PKDEVICE_QUEUE_ENTRY DeviceQueueEntry,
[in] ULONG SortKey
);
參數
[in, out] DeviceQueue
呼叫端提供記憶體之裝置佇列類型的控制件物件指標。
[in, out] DeviceQueueEntry
要根據特定索引鍵值插入裝置佇列中之裝置佇列專案的指標。
[in] SortKey
指定要在其中插入項目的裝置佇列中位置的排序索引鍵值。
傳回值
如果裝置佇列是空的， 則會 傳回 FALSE，這表示 DeviceQueueEntry 不會插入到裝置佇列中。
備註
取得指定的裝置佇列微調鎖定，並檢查裝置佇列的狀態。 如果裝置佇列設定為忙碌狀態， DeviceQueueEntry 指定的 IRP 會根據其排序索引鍵值插入裝置佇列，並釋放裝置佇列微調鎖定。
新項目位於裝置佇列中，其排序索引鍵值小於或等於其排序索引鍵值，並在具有更高排序索引鍵值的任何專案之前放置。
如果 KeInsertByKeyDeviceQueue 傳回 FALSE，呼叫端必須開始處理 IRP。 當佇列是空的時，呼叫 KeInsertDeviceQueue 或 KeInsertByKeyDeviceQueue 會導致裝置佇列從忙碌狀態轉換為忙碌狀態。
此例程適用於將 I/O 要求排入裝置驅動程式佇列的程式代碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | DISPATCH_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDDIs (storport) 、 IrqlDispatch (storport) 、IrqlDispatch (storport) 、 IrqlDispatch (wdm) 、 MarkingQueuedIrps (wdm) |