Share via

AvRtWaitOnThreadOrderingGroup-Funktion (avrt.h)

  • Artikel

Ermöglicht Clientthreads einer Threadreihenfolgegruppe, zu warten, bis sie ausgeführt werden sollen.

Syntax

AVRTAPI BOOL AvRtWaitOnThreadOrderingGroup(
  [in] HANDLE Context
);

Parameter

[in] Context

Ein Kontexthandle. Dieses Handle wird von der Funktion AvRtCreateThreadOrderingGroup oder AvRtJoinThreadOrderingGroup zurückgegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn diese Funktion zurückgegeben wird, sollte der Thread seine Verarbeitung für den Zeitraum abschließen und dann die Funktion erneut aufrufen.

Wenn der Thread während des timeout-Intervalls, das vom übergeordneten Thread beim Erstellen der Gruppe angegeben wird, seine Verarbeitung nicht abschließen kann, wird er aus der Threadreihenfolgegruppe gelöscht. Wenn der Thread seine Verarbeitungsschleife beendet, schlägt daher der nächste Aufruf von AvRtWaitOnThreadOrderingGroup fehl, und der letzte Fehlercode wird auf ERROR_ACCESS_DENIED festgelegt.

Wenn die Threadreihenfolgegruppe während der Wartezeit gelöscht wird, wird für diese Funktion schließlich ein Timeout ausgegeben und ERROR_ACCESS_DENIED zurückgegeben.

Beispiele

#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;
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile avrt.h
Bibliothek Avrt.lib
DLL Avrt.dll

Weitere Informationen

Threadreihenfolgedienst