共用方式為


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 背景工作線程的相關信息,請使用 QueryUmsThreadInformationSetUmsThreadInformation 函式

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

規格需求

需求
最低支援的用戶端 僅限 Windows 7 (64 位) [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll
API 集合 api-ms-win-core-ums-l1-1-0 (在 Windows 7)

另請參閱

CreateRemoteThreadEx

DeleteUmsThreadContext

InitializeProcThreadAttributeList

QueryUmsThreadInformation

SetUmsThreadInformation

UpdateProcThreadAttribute