Dreamine.Threading.Windows.Services.WindowsThreadAffinityService 클래스 참조

더 자세히 ...

Dreamine.Threading.Windows.Services.WindowsThreadAffinityService에 대한 상속 다이어그램 :

Dreamine.Threading.Windows.Services.WindowsThreadAffinityService에 대한 협력 다이어그램:

Public 멤버 함수
void	ApplyToCurrentThread (int coreIndex)
void	ClearCurrentThreadAffinity ()

상세한 설명

현재 Windows 스레드에 CPU 선호도를 적용합니다.

WindowsThreadAffinityService.cs 파일의 15 번째 라인에서 정의되었습니다.

멤버 함수 문서화

ApplyToCurrentThread()

void Dreamine.Threading.Windows.Services.WindowsThreadAffinityService.ApplyToCurrentThread ( int coreIndex )

inline

현재 Windows 스레드의 선호도 마스크를 지정한 단일 CPU 코어로 설정합니다.

매개변수

coreIndex

현재 프로세스 비트 폭 안의 0부터 시작하는 CPU 코어 인덱스입니다.

예외

ArgumentOutOfRangeException	coreIndex 가 음수이거나 선호도 마스크 비트 폭을 벗어날 때 발생합니다.
Win32Exception	Windows가 스레드 선호도 마스크 설정을 거부할 때 발생합니다.
DllNotFoundException	Windows 네이티브 라이브러리를 로드할 수 없을 때 발생할 수 있습니다.

WindowsThreadAffinityService.cs 파일의 57 번째 라인에서 정의되었습니다.

    {
        if (coreIndex < 0)
        {
            throw new ArgumentOutOfRangeException(nameof(coreIndex), "CPU core index cannot be negative.");
        }
 
        if (coreIndex >= IntPtr.Size * 8)
        {
            throw new ArgumentOutOfRangeException(
                nameof(coreIndex),
                $"CPU core index {coreIndex} exceeds the affinity mask width.");
        }
 
        var mask = new UIntPtr(1UL << coreIndex);
        var currentThread = Kernel32NativeMethods.GetCurrentThread();
 
        var previousMask = Kernel32NativeMethods.SetThreadAffinityMask(currentThread, mask);
 
        if (previousMask == UIntPtr.Zero)
        {
            throw new Win32Exception(
                System.Runtime.InteropServices.Marshal.GetLastWin32Error(),
                $"Failed to set thread affinity. CoreIndex={coreIndex}");
        }
    }

ClearCurrentThreadAffinity()

void Dreamine.Threading.Windows.Services.WindowsThreadAffinityService.ClearCurrentThreadAffinity ( )

inline

현재 스레드의 CPU 선호도를 해제합니다. 현재 구현은 이전 마스크를 보존하지 않아 아무 작업도 하지 않습니다.

실제 복원에는 ApplyToCurrentThread 호출 전에 이전 마스크를 스레드별로 보존하는 계약 확장이 필요합니다.

WindowsThreadAffinityService.cs 파일의 100 번째 라인에서 정의되었습니다.

    {
        /*
         * Windows SetThreadAffinityMask requires a valid mask.
         * Restoring the original process-wide scheduling behavior requires the previous
         * affinity mask to be stored per thread.
         *
         * The current Core interface does not expose a restore token, so this method is
         * intentionally a no-op for now.
         *
         * Future improvement:
         * - Change IThreadAffinityService.ApplyToCurrentThread to return a restore handle.
         * - Restore the previous affinity mask in Clear/Dispose.
         */
    }

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• WindowsThreadAffinityService.cs