KeInsertDeviceQueue 函式 (wdm.h)
KeInsertDeviceQueue 例程會取得指定裝置佇列物件的微調鎖定,如果裝置佇列設定為忙碌狀態,則會將指定的專案排入佇列。
語法
BOOLEAN KeInsertDeviceQueue(
[in, out] PKDEVICE_QUEUE DeviceQueue,
[in, out] PKDEVICE_QUEUE_ENTRY DeviceQueueEntry
);
參數
[in, out] DeviceQueue
呼叫端提供記憶體之裝置佇列類型的控制件物件指標。
[in, out] DeviceQueueEntry
要插入之裝置佇列專案的指標。
傳回值
如果裝置佇列是空的,則會傳回 FALSE , 而且 DeviceQueueEntry 不會插入裝置佇列中。
備註
如果裝置佇列設定為忙碌狀態,則會在裝置佇列的結尾插入指定的 DeviceQueueEntry ,並釋放裝置佇列微調鎖定。
如果 KeInsertDeviceQueue 傳回 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) |