Функция
GetThreadPriorityФункция
GetThreadPriority извлекает значение приоритета для определяемого потока. Это значение, вместе с классом приоритета процесса потока, обуславливает уровень базового приоритета потока.Синтаксис
GetThreadPriority(
); |
Параметры
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 |
Нет |
|
Замечания по платформе |
Не имеется |