createUmsThreadContext 函式 (winbase.h)

建立使用者模式排程 (UMS) 線程內容，以代表 UMS 背景工作線程。

警告

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

語法

BOOL CreateUmsThreadContext(
  [out] PUMS_CONTEXT *lpUmsThread
);

[out] lpUmsThread

PUMS_CONTEXT變數。在輸出時，此參數會接收UMS線程內容的指標。

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

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

傳回碼	Description
ERROR_NOT_ENOUGH_MEMORY	記憶體不足，無法建立UMS線程內容。

UMS 線程內容代表UMS背景工作線程的狀態。線程內容可用來在函數調用中指定 UMS 背景工作線程。

使用 InitializeProcThreadAttributeList 和 UpdateProcThreadAttribute 來準備線程的 UMS 屬性列表之後，會呼叫 CreateRemoteThreadEx 函式來建立 UMS 背景工作線程。

UMS 線程內容的基礎結構是由系統管理，不應直接修改。若要取得和設定 UMS 背景工作線程的相關信息，請使用 QueryUmsThreadInformation 和 SetUmsThreadInformation 函式。

UMS 背景工作線程終止之後，應該藉由呼叫 DeleteUmsThreadContext 來釋放其線程內容。