Fonction ExecuteUmsThread (winbase.h)

Exécute le thread de travail UMS spécifié.

Syntaxe

BOOL ExecuteUmsThread(
  [in, out] PUMS_CONTEXT UmsThread
);

Paramètres

[in, out] UmsThread

Pointeur vers le contexte de thread UMS du thread worker à exécuter.

Valeur retournée

Si la fonction réussit, elle ne retourne pas de valeur.

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

Remarques

La fonction ExecuteUmsThread charge l’état du thread worker UMS spécifié sur l’état du thread de planificateur UMS appelant afin que le thread worker puisse s’exécuter. Le thread de travail s’exécute jusqu’à ce qu’il génère en appelant la fonction UmsThreadYield , en bloquant ou en se terminant.

Lorsqu’un thread worker génère ou bloque, le système appelle la fonction de point d’entrée UmsSchedulerProc du thread du planificateur. Lorsqu’un thread worker précédemment bloqué est débloqué, le système met en file d’attente le thread worker vers la liste d’achèvement spécifiée avec la fonction UpdateProcThreadAttribute lors de la création du thread worker.

La fonction ExecuteUmsThread ne retourne pas, sauf si une erreur se produit. Si la fonction retourne ERROR_RETRY, l’erreur est temporaire et l’opération peut être retentée.

Si la fonction retourne une erreur autre que ERROR_RETRY, le planificateur de l’application doit case activée si le thread est suspendu ou arrêté en appelant QueryUmsThreadInformation avec respectivement UmsThreadIsSuspended ou UmsThreadIsTerminated. D’autres erreurs possibles incluent l’appel de la fonction sur un thread qui n’est pas un thread de planificateur UMS, la transmission d’un contexte de thread de travail UMS non valide ou la spécification d’un thread worker qui s’exécute déjà sur un autre thread de planificateur.

Configuration requise

Voir aussi

UmsSchedulerProc

UmsThreadYield

UpdateProcThreadAttribute