Функция QueryUmsThreadInformation (winbase.h)

Статья
08/27/2023

Извлекает сведения о указанном рабочем потоке планирования пользовательского режима (UMS).

Предупреждение

С Windows 11 года планирование в пользовательском режиме не поддерживается. Все вызовы завершаются ошибкой ERROR_NOT_SUPPORTED.

Синтаксис

BOOL QueryUmsThreadInformation(
  [in]            PUMS_CONTEXT          UmsThread,
  [in]            UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [out]           PVOID                 UmsThreadInformation,
  [in]            ULONG                 UmsThreadInformationLength,
  [out, optional] PULONG                ReturnLength
);

Параметры

[in] UmsThread

Указатель на контекст потока UMS.

[in] UmsThreadInfoClass

Значение UMS_THREAD_INFO_CLASS, указывающее тип извлекаемой информации.

[out] UmsThreadInformation

Указатель на буфер для получения указанных сведений. Требуемый размер этого буфера зависит от указанного класса информации.

Если информационный класс — UmsThreadContext или UmsThreadTeb, буфер должен иметь значение sizeof(PVOID).

Если информационный класс — UmsThreadIsSuspended или UmsThreadIsTerminated, буфер должен иметь значение sizeof(BOOLEAN).

[in] UmsThreadInformationLength

Размер буфера UmsThreadInformation в байтах.

[out, optional] ReturnLength

Указатель на переменную ULONG. В выходных данных этот параметр получает количество байтов, записанных в буфер UmsThreadInformation .

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

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

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. Возможные значения ошибок:

Код возврата	Описание
ERROR_INFO_LENGTH_MISMATCH	Буфер слишком мал для запрошенной информации.
ERROR_INVALID_INFO_CLASS	Указанный информационный класс не поддерживается.
ERROR_NOT_SUPPORTED	UMS не поддерживается.

Функция QueryUmsThreadInformation извлекает сведения о указанном рабочем потоке UMS, такие как контекст, определенный приложением, блок выполнения потока (TEB), а также о том, приостановлен или завершен поток.

Базовые структуры для рабочих потоков UMS управляются системой. Сведения, которые не предоставляются через QueryUmsThreadInformation , следует считать зарезервированными.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 (только 64-разрядная версия) [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll
Набор API	api-ms-win-core-ums-l1-1-0 (появилось в Windows 7)

См. также раздел

SetUmsThreadInformation

UMS_THREAD_INFO_CLASS

Поделиться через