PWAITCHAINCALLBACK-Rückruffunktion (wct.h)

Artikel
08/27/2023

Eine anwendungsdefinierte Rückruffunktion, die eine Wartekette empfängt. Geben Sie diese Adresse beim Aufrufen der OpenThreadWaitChainSession-Funktion an.

Der PWAITCHAINCALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. WaitChainCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PWAITCHAINCALLBACK Pwaitchaincallback;

void Pwaitchaincallback(
  HWCT WctHandle,
  DWORD_PTR Context,
  DWORD CallbackStatus,
  LPDWORD NodeCount,
  PWAITCHAIN_NODE_INFO NodeInfoArray,
  LPBOOL IsCycle
)
{...}

Parameter

WctHandle

Ein Handle für die WCT-Sitzung, die von der OpenThreadWaitChainSession-Funktion erstellt wurde.

Context

Ein optionaler Zeiger auf eine anwendungsdefinierte Kontextstruktur, die von der GetThreadWaitChain-Funktion angegeben wird.

CallbackStatus

Der Rückruf status. Dieser Parameter kann einer der folgenden Werte oder einer der anderen Systemfehlercodes sein.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Der Aufrufer verfügte nicht über ausreichende Berechtigungen zum Öffnen eines Zielthreads.
ERROR_CANCELLED	Die asynchrone Sitzung wurde durch einen Aufruf der CloseThreadWaitChainSession-Funktion abgebrochen.
ERROR_MORE_DATA	Der NodeInfoArray-Puffer ist nicht groß genug, um alle Knoten in der Wartekette zu enthalten. Der NodeCount-Parameter enthält die Anzahl der Knoten in der Kette. Die zurückgegebene Wartekette ist weiterhin gültig.
ERROR_OBJECT_NOT_FOUND	Der angegebene Thread konnte nicht gefunden werden.
ERROR_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
ERROR_TOO_MANY_THREADS	Die Anzahl der Knoten überschreitet WCT_MAX_NODE_COUNT. Die zurückgegebene Wartekette ist weiterhin gültig.

NodeCount

Die Anzahl der abgerufenen Knoten bis zu WCT_MAX_NODE_COUNT. Wenn das Array nicht alle Knoten der Wartekette enthalten kann, schlägt die Funktion fehl, CallbackStatus ist ERROR_MORE_DATA, und dieser Parameter empfängt die Anzahl der Arrayelemente, die erforderlich sind, um alle Knoten zu enthalten.

NodeInfoArray

Ein Array von WAITCHAIN_NODE_INFO Strukturen, das die Wartekette empfängt.

IsCycle

Wenn die Funktion einen Deadlock erkennt, wird diese Variable auf TRUE festgelegt. Andernfalls ist er auf FALSE festgelegt.

Rückgabewert

Keine

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	wct.h

Weitere Informationen

GetThreadWaitChain

OpenThreadWaitChainSession

WAITCHAIN_NODE_INFO

Freigeben über