Compartilhar via


Função UmsThreadYield (winbase.h)

Gera controle para o thread do agendador UMS (agendamento no modo de usuário) no qual o thread de trabalho umS de chamada está em execução.

Aviso

A partir de Windows 11, não há suporte para o agendamento no modo de usuário. Todas as chamadas falham com o erro ERROR_NOT_SUPPORTED.

Sintaxe

BOOL UmsThreadYield(
  [in] PVOID SchedulerParam
);

Parâmetros

[in] SchedulerParam

Um parâmetro a ser passado para a função UmsSchedulerProc do thread do agendador.

Valor retornado

Se a função for bem-sucedida, ela retornará um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um thread de trabalho da UMS chama a função UmsThreadYield para produzir de forma cooperativa o controle para o thread do agendador UMS no qual o thread de trabalho está em execução. Se um thread de trabalho umS nunca chamar UmsThreadYield, o thread de trabalho será executado até que seja bloqueado ou encerrado.

Quando o controle alterna para o thread do agendador UMS, o sistema chama a função de ponto de entrada do agendador associado com o motivo UmsSchedulerThreadYield e o parâmetro ScheduleParam especificados pelo thread de trabalho na chamada UmsThreadYield .

O agendador do aplicativo é responsável por reagendar o thread de trabalho.

Requisitos

   
Cliente mínimo com suporte Windows 7 (somente 64 bits) [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll
Conjunto de APIs api-ms-win-core-ums-l1-1-0 (introduzido no Windows 7)

Confira também

UmsSchedulerProc