SetThreadAffinityMask设置线程亲缘性

The SetThreadAffinityMask function sets a processor affinity mask for the specified thread.

DWORD_PTR SetThreadAffinityMask(
  HANDLE hThread,
  DWORD_PTR dwThreadAffinityMask
);

Parameters

hThread

[in] Handle to the thread whose affinity mask is to be set.

This handle must have the THREAD_SET_INFORMATION and THREAD_QUERY_INFORMATION access rights. For more information, see Thread Security and Access Rights.

dwThreadAffinityMask

[in] Affinity mask for the thread.

Windows Me/98/95:  This value must be 1.

Return Values

If the function succeeds, the return value is the thread's previous affinity mask.

Windows Me/98/95:  The return value is 1. To succeed, hThread must be valid and dwThreadAffinityMask must be 1.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

A thread affinity mask is a bit vector in which each bit represents the processors that a thread is allowed to run on.

A thread affinity mask must be a proper subset of the process affinity mask for the containing process of a thread. A thread is only allowed to run on the processors its process is allowed to run on.

通过调用SetThreadAffinityMask，就能为各个线程设置亲缘性屏蔽：

DWORD_PTR SetThreadAffinityMask(HANDLE hThread, DWORD_PTR dwThreadAffinityMask);

该函数中的h T h r e a d参数用于指明要限制哪个线程， dwThreadAffinityMask用于指明该线程能够在哪个CPU上运行。dwThreadAffinityMask必须是进程的亲缘性屏蔽的相应子集。返回值是线程的前一个亲缘性屏蔽。

因此，若要将3个线程限制到CPU1、2和3上去运行，可以这样操作：

//Thread 0 can only run on CPU 0.

SetThreadAffinityMask(hThread0, 0x00000001); //第0位是1

//Threads 1, 2, 3 run on CPUs 1, 2, 3.//第1 2 3位是1

SetThreadAffinityMask(hThread1, 0x0000000E);

SetThreadAffinityMask(hThread2, 0x0000000E);

SetThreadAffinityMask(hThread3, 0x0000000E);