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 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | DISPATCH_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIS（storport），IrqlDispatch（storport），IrqlDispatch（storport），IrqlDispatch（wdm），標記QueuedIrps（wdm） |