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

Запускает указанный рабочий поток UMS.

Синтаксис

BOOL ExecuteUmsThread(
  [in, out] PUMS_CONTEXT UmsThread
);

Параметры

[in, out] UmsThread

Указатель на контекст потока UMS для запуска рабочего потока.

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

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

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

Комментарии

Функция ExecuteUmsThread загружает состояние указанного рабочего потока UMS через состояние вызывающего потока планировщика UMS, чтобы рабочий поток можно было запустить. Рабочий поток выполняется до тех пор, пока он не будет получен путем вызова функции UmsThreadYield , блокирует или завершает работу.

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

Функция ExecuteUmsThread не возвращает, если не возникнет ошибка. Если функция возвращает ERROR_RETRY, ошибка является временной, и операцию можно повторить.

Если функция возвращает ошибку, отличающаяся от ERROR_RETRY, планировщик приложения должен проверка, будет ли поток приостановлен или завершен путем вызова QueryUmsThreadInformation с UmsThreadIsSuspended или UmsThreadIsTerminated соответственно. Другие возможные ошибки включают вызов функции в потоке, который не является потоком планировщика UMS, передача недопустимого контекста рабочего потока UMS или указание рабочего потока, который уже выполняется в другом потоке планировщика.

Требования

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

UmsSchedulerProc

UmsThreadYield

UpdateProcThreadAttribute