Share via

getUmsSystemThreadInformation 函式 (winbase.h)

  • 發行項

查詢指定的線程是UMS排程器線程、UMS背景工作線程或非UMS線程。

警告

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

語法

BOOL GetUmsSystemThreadInformation(
  [in]      HANDLE                         ThreadHandle,
  [in, out] PUMS_SYSTEM_THREAD_INFORMATION SystemThreadInfo
);

參數

[in] ThreadHandle

線程的句柄。 線程句柄必須具有THREAD_QUERY_INFORMATION訪問許可權。 如需詳細資訊，請參閱 線程安全性和訪問許可權。

[in, out] SystemThreadInfo

接收指定線程相關信息 之UMS_SYSTEM_THREAD_INFORMATION 結構的指標。

呼叫端必須在呼叫之前初始化 UmsVersion 成員。

傳回值

如果此函式失敗，則傳回值為零。

若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

GetUmsSystemThreadInformation 函式適用於調試程式、疑難解答工具和程式碼剖析應用程式。 例如，線程隔離追蹤或單一逐步執行指示可能牽涉到暫停進程中所有其他線程。 不過，如果要追蹤的線程是UMS背景工作線程，暫停UMS排程器線程可能會造成死結，因為UMS背景工作線程需要UMS排程器線程的介入才能執行。 調試程式可以針對可能暫停的每個線程呼叫 GetUmsSystemThreadInformation 來判斷線程類型，然後視需要暫停或不需要偵錯程序代碼。

規格需求

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