Fonction AvRtJoinThreadOrderingGroup (avrt.h)

Joint les threads clients à un groupe de classement des threads.

Syntaxe

AVRTAPI BOOL AvRtJoinThreadOrderingGroup(
  [out] PHANDLE Context,
  [in]  GUID    *ThreadOrderingGuid,
  [in]  BOOL    Before
);

Paramètres

[out] Context

Pointeur vers un handle de contexte.

[in] ThreadOrderingGuid

Pointeur vers l’identificateur unique du groupe de tri des threads.

[in] Before

Ordre des threads. Si ce paramètre a la valeur TRUE, le thread est un thread prédécesseur qui est planifié pour s’exécuter avant le thread parent. Si ce paramètre a la valeur FALSE, le thread est un thread successeur qui est planifié pour s’exécuter après le thread parent.

Valeur retournée

Si la fonction réussit, la valeur de retour est 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

Le thread entoure le code à exécuter pendant chaque période au sein d’une boucle contrôlée par la fonction AvRtWaitOnThreadOrderingGroup .

Un thread peut créer plusieurs groupes de classement de threads et rejoindre plusieurs groupes de classement de threads. Toutefois, un thread ne peut pas rejoindre le même groupe de classement de threads plusieurs fois.

Le nombre de threads pouvant rejoindre un groupe est limité uniquement par les ressources système disponibles.

Configuration requise

Voir aussi

Service de classement des threads