Функция CreateUmsThreadContext (winbase.h)
Создает контекст потока планирования пользовательского режима (UMS) для представления рабочего потока UMS.
Предупреждение
С Windows 11 года планирование в пользовательском режиме не поддерживается. Все вызовы завершаются ошибкой ERROR_NOT_SUPPORTED.
Синтаксис
BOOL CreateUmsThreadContext(
[out] PUMS_CONTEXT *lpUmsThread
);
Параметры
[out] lpUmsThread
Переменная PUMS_CONTEXT. В выходных данных этот параметр получает указатель на контекст потока UMS.
Возвращаемое значение
Если функция выполняется успешно, она возвращает ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. Возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Недостаточно памяти для создания контекста потока 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) |