createUmsCompletionList 函式 (winbase.h)

建立使用者模式排程 (UMS) 完成清單。

警告

自 Windows 11 起，不支援使用者模式排程。所有呼叫都會失敗，並出現錯誤 ERROR_NOT_SUPPORTED 。

語法

BOOL CreateUmsCompletionList(
  [out] PUMS_COMPLETION_LIST *UmsCompletionList
);

[out] UmsCompletionList

PUMS_COMPLETION_LIST變數。在輸出時，此參數會收到空白 UMS 完成清單的指標。

如果函式成功，則會傳回非零值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。可能的錯誤值包括下列專案。

傳回碼	描述
ERROR_NOT_ENOUGH_MEMORY	記憶體不足，無法建立完成清單。
ERROR_NOT_SUPPORTED	不支援 UMS。

呼叫 EnterUmsSchedulingMode 函式以建立排程器執行緒時，完成清單會與 UMS 排程器執行緒相關聯。系統會將新建立的 UMS 背景工作執行緒排入完成清單。當執行緒不再遭到封鎖時，它也會將先前封鎖的 UMS 背景工作執行緒排入完成清單。

呼叫應用程式的 UmsSchedulerProc 進入點函式時，應用程式的排程器應該呼叫 DequeueUmsCompletionListItems，從完成清單中擷取專案。

每個完成清單都有相關聯的完成清單事件，每當系統將專案排入空白清單時，就會發出訊號。使用 GetUmsCompletionListEvent 取得指定完成清單之事件的控制碼。

不再需要完成清單時，請使用 DeleteUmsCompletionList 來釋放清單。清單必須空白，才能釋出列表。