Функция SetThreadIdealProcessor

Функция SetThreadIdealProcessor устанавливает предпочитаемый процессор для потока. Всякий раз, когда это возможно, система устанавливает очередность обслуживания потоков на их привилегированных процессорах.

Синтаксис

DWORD SetThreadIdealProcessor(

HANDLE hThread,        // дескриптор потока

DWORD dwIdealProcessor // номер идеального процессора

);

Параметры

hThread

[in] Дескриптор потока, привилегированный процессор которого должен быть установлен. Дескриптор должен иметь право доступа THREAD_SET_INFORMATION связанное с ним. Для получения дополнительной информации, см. статью Защита потока и права доступа.

dwIdealProcessor

[in] Номер привилегированного процессора для потока. Значение MAXIMUM_PROCESSORS сообщает системе, что поток не имеет привилегированного процессора.

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

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

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

Замечания

Вы можете использовать функцию GetSystemInfo, чтобы установить число процессоров на компьютере. Вы можете также использовать и функцию GetProcessAffinityMask, чтобы проверить процессоры, на которых поток имеет разрешение на запуск.

Обратите внимание! на то, что GetProcessAffinityMask возвращает бит маски, несмотря на то, что SetThreadIdealProcessor использует целочисленное значение, чтобы обозначить процессор.

Чтобы компилировать приложение, которое использует эту функцию, определите макрокоманду _WIN32_WINNT как 0x0400 или позже. Для получения дополнительной информации, см. Использование заголовков SDK.

Смотри также

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

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

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

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

Kernel32.lib

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

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz