Функция SetThreadAffinityMask

Функция SetThreadAffinityMask устанавливает маску родственности процессора для заданного потока.

Синтаксис

DWORD SetThreadAffinityMask (

HANDLE hThread,                // дескриптор потока
DWORD_PTR
dwThreadAffinityMask // маска родственности потока

);

Параметры

hThread

[in] Дескриптор потока, маску родственности которого устанавливает функция.

Windows NT/2000/XP: Этот дескриптор должен иметь права доступа THREAD_SET_INFORMATION и THREAD_QUERY_INFORMATION. Для получения дополнительной информации, см. статью Защита потока и права доступа.

dwThreadAffinityMask

Windows NT/2000/XP: [in] Маска родственности для потока.

Windows 95/98/Me: [in] Это значение должно быть 1.

Возвращаемые значения

Если функция завершается успешно, величина возвращаемого значения - не ноль.

Windows NT/2000/XP: величина возвращаемого значения - предшествующая маска родственности потока.

Windows 95/98/Me: величина возвращаемого значения является 1. Чтобы завершаться успешно, параметр hThread должен быть допустим, а dwThreadAffinityMask должен быть 1.

Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получить дополнительные данные об ошибках, вызовите GetLastError.

Замечания

Маской родственности потока является битовый вектор, каждый бит которого обозначает процессоры, на которых потоку разрешается запуститься.

Маска родственности потока должна быть собственным подмножеством маски родственности процесса для процесса содержащего поток. Потоку позволяется запуститься только на процессорах, на которых запущен его процесс.

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, GetProcessAffinityMask, OpenThread, SetThreadIdealProcessor

Размещение и совместимость SetThreadAffinityMask

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.5 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz