KsQueueWorkItem 函式 (ks.h)
KsQueueWorkItem 函式會將指定的工作專案排入 KsRegisterWorker 函式先前建立的背景工作專案。
語法
KSDDKAPI NTSTATUS KsQueueWorkItem(
[in] PKSWORKER Worker,
[in] PWORK_QUEUE_ITEM WorkItem
);
參數
[in] Worker
指定先前配置的背景工作角色。
[in] WorkItem
指定要排入佇列的初始化工作專案。 只要背景工作角色在佇列上,此工作專案才會與背景工作角色相關聯。 工作項目必須由 ioAllocateWorkItem 初始化。
傳回值
如果工作專案已排入佇列,則 KsQueueWorkItem 函式會傳回STATUS_SUCCESS;如果目前沒有可用的線程,則函式會傳回錯誤。
言論
背景工作角色只能在一個位置的佇列上,因此背景工作角色的後續佇列必須等到工作專案開始執行為止。 此函式可能會在 DISPATCH_LEVEL呼叫。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |