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) |