Función UmsThreadYield (winbase.h)
Produce el control para el subproceso del programador de programación en modo de usuario (UMS) en el que se ejecuta el subproceso de trabajo de UMS que realiza la llamada.
Advertencia
A partir de Windows 11, no se admite la programación en modo de usuario. Todas las llamadas producen el error ERROR_NOT_SUPPORTED.
Sintaxis
BOOL UmsThreadYield(
[in] PVOID SchedulerParam
);
Parámetros
[in] SchedulerParam
Parámetro que se va a pasar a la función UmsSchedulerProc del subproceso del programador.
Valor devuelto
Si la función se ejecuta correctamente, devuelve un valor distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Un subproceso de trabajo de UMS llama a la función UmsThreadYield para producir de forma cooperativa el control al subproceso del programador de UMS en el que se ejecuta el subproceso de trabajo. Si un subproceso de trabajo de UMS nunca llama a UmsThreadYield, el subproceso de trabajo se ejecuta hasta que se bloquea o finaliza.
Cuando el control cambia al subproceso del programador de UMS, el sistema llama a la función de punto de entrada del programador asociado con la razón UmsSchedulerThreadYield y el parámetro ScheduleParam especificado por el subproceso de trabajo en la llamada umsThreadYield .
El programador de la aplicación es responsable de volver a programar el subproceso de trabajo.
Requisitos
| Cliente mínimo compatible | Windows 7 (solo 64 bits) [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winbase.h (incluya Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |
| Conjunto de API | api-ms-win-core-ums-l1-1-0 (introducido en Windows 7) |