Функция GetThreadPriority

Функция GetThreadPriority извлекает значение приоритета для определяемого потока. Это значение, вместе с классом приоритета процесса потока, обуславливает уровень базового приоритета потока.

Синтаксис

int GetThreadPriority(

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

);

Параметры

hThread

[in] Дескриптор потока.

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

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

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

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

Уровень приоритета потока - одно из нижеследующих значений:

Приоритет

Предназначение

THREAD_PRIORITY_ABOVE_NORMAL

Приоритет на 1 пункт выше класса приоритета

THREAD_PRIORITY_BELOW_NORMAL

Приоритет на 1 пункт ниже класса приоритета.

THREAD_PRIORITY_HIGHEST

Приоритет на 2 пункта выше класса приоритета.

THREAD_PRIORITY_IDLE

Базовый приоритет 1 для IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, ABOVE_NORMAL_PRIORITY_CLASS или HIGH_PRIORITY_CLASS процессов и базовый приоритет 16 для процессов REALTIME_PRIORITY_CLASS.

THREAD_PRIORITY_LOWEST

Приоритет на 2 пункта ниже класса приоритета.

THREAD_PRIORITY_NORMAL

Обозначает нормальный приоритет для класса приоритета.

THREAD_PRIORITY_TIME_CRITICAL

Уровень базового приоритета 15 для процессов IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, ABOVE_NORMAL_PRIORITY_CLASS или HIGH_PRIORITY_CLASS, и уровень базового приоритета 31 для процессов REALTIME_PRIORITY_CLASS.

Замечания

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

За таблицей, которая показывает уровни базового приоритета для каждой комбинации класса приоритета и значения приоритета потока, обратитесь к функции SetPriorityClass.

Смотри также

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

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

Kernel32.lib

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

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz