SetThreadIdealProcessor 函式 (processthreadsapi.h)

發行項
03/13/2024

設定線程的慣用處理器。系統會盡可能排程其慣用處理器上的線程。

在超過 64 個處理器的系統上，此函式會將慣用處理器設定為指派呼叫線程之處理器群組中的邏輯處理器。使用 SetThreadIdealProcessorEx 函式來指定處理器群組和慣用處理器。

語法

DWORD SetThreadIdealProcessor(
  [in] HANDLE hThread,
  [in] DWORD  dwIdealProcessor
);

參數

[in] hThread

要設定慣用處理器之線程的句柄。句柄必須具有THREAD_SET_INFORMATION訪問許可權。如需詳細資訊，請參閱線程安全性和訪問許可權。

[in] dwIdealProcessor

線程慣用處理器的數目。此值是以零起始。如果此參數MAXIMUM_PROCESSORS，函式會傳回目前的理想處理器，而不需加以變更。

傳回值

如果函式成功，則傳回值是先前慣用的處理器。

如果函式失敗，傳回值會 (DWORD) – 1。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

您可以使用 GetSystemInfo 函式來判斷電腦上的處理器數目。您也可以使用 GetProcessAffinityMask 函式來檢查允許線程執行的處理器。請注意， GetProcessAffinityMask 會傳回位掩碼， 而 SetThreadIdealProcessor 會使用整數值來代表處理器。

從 Windows 11 和 Windows Server 2022 開始，在具有超過 64 個處理器的系統上，進程和線程親和性預設會跨越系統中所有處理器群組。 SetThreadIdealProcessor 函式會將慣用處理器設定為線程主要群組中的邏輯處理器。

若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0400或更新版本。如需詳細資訊，請參閱使用 Windows 標頭。

Windows 8.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更新版本上的 Windows 市集應用程式支援此函式。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	processthreadsapi.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll