UmsThreadYield, fonction (winbase.h)
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) |