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。 當佇列是空的時,呼叫 KeInsertDeviceQueueKeInsertByKeyDeviceQueue 會導致裝置佇列從非忙碌狀態變更為忙碌狀態。

此常式適用于將 I/O 要求排入設備磁碟機佇列的程式碼。

規格需求

   
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 環球
標頭 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)

另請參閱

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

KeRemoveDeviceQueue

KeRemoveEntryDeviceQueue