UmsThreadYield, fonction (winbase.h)

  • Article

Fournit le contrôle au thread du planificateur en mode utilisateur (UMS) sur lequel le thread de travail UMS appelant est en cours d’exécution.

Avertissement

À partir de Windows 11, la planification en mode utilisateur n’est pas prise en charge. Tous les appels échouent avec l’erreur ERROR_NOT_SUPPORTED.

Syntaxe

BOOL UmsThreadYield(
  [in] PVOID SchedulerParam
);

Paramètres

[in] SchedulerParam

Paramètre à passer à la fonction UmsSchedulerProc du thread de planificateur.

Valeur retournée

Si la fonction réussit, elle retourne une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Un thread de travail UMS appelle la fonction UmsThreadYield pour fournir de manière coopérative le contrôle au thread du planificateur UMS sur lequel le thread de travail s’exécute. Si un thread de travail UMS n’appelle jamais UmsThreadYield, le thread de travail s’exécute jusqu’à ce qu’il soit bloqué ou terminé.

Lorsque le contrôle bascule vers le thread du planificateur UMS, le système appelle la fonction de point d’entrée du planificateur associée avec la raison UmsSchedulerThreadYield et le paramètre ScheduleParam spécifié par le thread worker dans l’appel UmsThreadYield .

Le planificateur de l’application est responsable de la rééchelonnement du thread de travail.

Configuration requise

   
Client minimal pris en charge Windows 7 (64 bits uniquement) [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll
Ensemble d’API api-ms-win-core-ums-l1-1-0 (introduit dans Windows 7)

Voir aussi

UmsSchedulerProc