SetThreadSelectedCpuSetMasks 函式 (processthreadsapi.h)

為指定的線程設定選取的CPU集合指派。如果已設定此指派，此指派會覆寫進程預設指派。

語法

BOOL SetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount
);

Thread

指定要設定 CPU 集合指派的線程。 PROCESS_SET_LIMITED_INFORMATION 訪問許可權。您也可以在這裡指定 GetCurrentProcess 傳回的值。

CpuSetMasks

指定要設定為線程所選取 CPU 集的選擇性GROUP_AFFINITY 結構緩衝區。如果這是 NULL，SetThreadSelectedCpuSetMasks 函 式會清除任何指派，如果已設定指派，則會還原為處理預設指派。

CpuSetMaskCount

指定 GroupCpuSets 自變數所傳遞清單中 GROUP_AFFINITY 結構的數目。如果緩衝區為 NULL，這個值必須是零。

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

如果函式失敗，傳回值為零，而且呼叫 GetLastError 即可擷取擴充錯誤資訊。

此函式類似於 SetThreadSelectedCpuSets，不同之處在於它會使用群組親和性，而不是 CPU 集合標識符來代表 CPU 集合清單。這表示產生的線程選取的CPU集合指派是所提供群組親和性清單中具有主處理器的所有CPU集合集合。