SetProcessAffinityMask

SetProcessAffinityMask sets a processor affinity mask for the threads of the specified process.

Syntax

BOOL SetProcessAffinityMask(
    HANDLE hProcess,
    DWORD_PTR dwProcessAffinityMask
);

Parameters

hProcess

A handle to the process whose affinity mask is to be set.

dwProcessAffinityMask

The affinity mask for all the threads of the process.

Return Value

A non-zero value if the function succeeds, 0 (zero) if the function fails

To get extended error information, call GetLastError.

Remarks

A process affinity mask is a bit vector in which each bit represents the processor on which the threads of the process are allowed to run. See Specifying a Processor Affinity Bitmask for details.

The value of the process affinity mask must be a subset of the RTSS system affinity mask values obtained by the GetProcessAffinityMask function.

Requirements

Minimum Supported Version	RTX64 2013
Header	windows.h
Library	Rtx_Rtss.lib

See Also:

GetProcessAffinityMask