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


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

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

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

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

Синтаксис

BOOL CreateUmsThreadContext(
  [out] PUMS_CONTEXT *lpUmsThread
);

Параметры

[out] lpUmsThread

Переменная PUMS_CONTEXT. В выходных данных этот параметр получает указатель на контекст потока UMS.

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

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

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

Код возврата Описание
ERROR_NOT_ENOUGH_MEMORY
Недостаточно памяти для создания контекста потока UMS.

Комментарии

Контекст потока UMS представляет состояние рабочего потока UMS. Контексты потоков используются для указания рабочих потоков UMS в вызовах функций.

Рабочий поток UMS создается путем вызова функции CreateRemoteThreadEx после использования InitializeProcThreadAttributeList и UpdateProcThreadAttribute для подготовки списка атрибутов UMS для потока.

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

После завершения рабочего потока UMS контекст его потока следует освободить, вызвав Метод DeleteUmsThreadContext.

Требования

Требование Значение
Минимальная версия клиента 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)

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

CreateRemoteThreadEx

DeleteUmsThreadContext

InitializeProcThreadAttributeList

QueryUmsThreadInformation

SetUmsThreadInformation

UpdateProcThreadAttribute