Fonction AvRtWaitOnThreadOrderingGroup (avrt.h)

Article
02/26/2024

Permet aux threads clients d’un groupe de tri des threads d’attendre qu’ils s’exécutent.

Syntaxe

AVRTAPI BOOL AvRtWaitOnThreadOrderingGroup(
  [in] HANDLE Context
);

Paramètres

[in] Context

Handle de contexte. Ce handle est retourné par la fonction AvRtCreateThreadOrderingGroup ou AvRtJoinThreadOrderingGroup .

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

Lorsque cette fonction est retournée, le thread doit terminer son traitement pour la période, puis appeler à nouveau la fonction.

Si le thread ne parvient pas à terminer son traitement pendant l’intervalle de délai d’attente spécifié par le thread parent lors de la création du groupe, il est supprimé du groupe de classement des threads. Par conséquent, lorsque le thread termine sa boucle de traitement, l’appel suivant à AvRtWaitOnThreadOrderingGroup échoue et le dernier code d’erreur est défini sur ERROR_ACCESS_DENIED.

Si le groupe de tri des threads est supprimé pendant l’attente, cette fonction finit par expirer et retourner ERROR_ACCESS_DENIED.

Exemples

#include <windows.h>
#include <avrt.h>
#include <stdio.h>

#pragma comment(lib, "Avrt.lib")

HANDLE Context;

int main( void )
{
    while(AvRtWaitOnThreadOrderingGroup(Context))
    {
        // Complete task for this period.
    }

return 0;
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	avrt.h
Bibliothèque	Avrt.lib
DLL	Avrt.dll

Voir aussi

Service de classement des threads

Partager via