Función UmsThreadYield (winbase.h)

  • Artículo

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)

Consulte también

UmsSchedulerProc