Funzione callback PWAITCHAINCALLBACK (wct.h)

Articolo
03/13/2024

Funzione di callback definita dall'applicazione che riceve una catena di attesa. Specificare questo indirizzo quando si chiama la funzione OpenThreadWaitChainSession .

Il tipo PWAITCHAINCALLBACK definisce un puntatore a questa funzione di callback. WaitChainCallback è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PWAITCHAINCALLBACK Pwaitchaincallback;

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

Parametri

WctHandle

Handle per la sessione WCT creata dalla funzione OpenThreadWaitChainSession .

Context

Puntatore facoltativo a una struttura di contesto definita dall'applicazione specificata dalla funzione GetThreadWaitChain .

CallbackStatus

Stato di callback. Questo parametro può essere uno dei valori seguenti o uno degli altri codici di errore di sistema.

Valore	Significato
ERROR_ACCESS_DENIED	Il chiamante non ha privilegi sufficienti per aprire un thread di destinazione.
ERROR_CANCELLED	La sessione asincrona è stata annullata da una chiamata alla funzione CloseThreadWaitChainSession .
ERROR_MORE_DATA	Il buffer NodeInfoArray non è sufficiente per contenere tutti i nodi nella catena di attesa. Il parametro NodeCount contiene il numero di nodi nella catena. La catena di attesa restituita è ancora valida.
ERROR_OBJECT_NOT_FOUND	Impossibile individuare il thread specificato.
ERROR_SUCCESS	Operazione riuscita.
ERROR_TOO_MANY_THREADS	Il numero di nodi supera WCT_MAX_NODE_COUNT. La catena di attesa restituita è ancora valida.

NodeCount

Numero di nodi recuperati, fino a WCT_MAX_NODE_COUNT. Se la matrice non può contenere tutti i nodi della catena di attesa, la funzione ha esito negativo, CallbackStatus è ERROR_MORE_DATA e questo parametro riceve il numero di elementi della matrice necessari per contenere tutti i nodi.

NodeInfoArray

Matrice di strutture WAITCHAIN_NODE_INFO che ricevono la catena di attesa.

IsCycle

Se la funzione rileva un deadlock, questa variabile è impostata su TRUE; in caso contrario, è impostato su FALSE.

Valore restituito

nessuno

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wct.h

Vedi anche

GetThreadWaitChain

OpenThreadWaitChainSession

WAITCHAIN_NODE_INFO

Condividi tramite