AvRtWaitOnThreadOrderingGroup-Funktion (avrt.h)
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 |