Función de devolución de llamada PWAITCHAINCALLBACK (wct.h)

Función de devolución de llamada definida por la aplicación que recibe una cadena de espera. Especifique esta dirección al llamar a la función OpenThreadWaitChainSession .

El tipo PWAITCHAINCALLBACK define un puntero a esta función de devolución de llamada. WaitChainCallback es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

PWAITCHAINCALLBACK Pwaitchaincallback;

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

Parámetros

WctHandle

Identificador de la sesión WCT creada por la función OpenThreadWaitChainSession .

Context

Puntero opcional a una estructura de contexto definida por la aplicación especificada por la función GetThreadWaitChain .

CallbackStatus

Estado de devolución de llamada. Este parámetro puede ser uno de los siguientes valores o uno de los otros códigos de error del sistema.

Valor	Significado
ERROR_ACCESS_DENIED	El autor de la llamada no tenía privilegios suficientes para abrir un subproceso de destino.
ERROR_CANCELLED	La sesión asincrónica se canceló mediante una llamada a la función CloseThreadWaitChainSession .
ERROR_MORE_DATA	El búfer NodeInfoArray no es lo suficientemente grande como para contener todos los nodos de la cadena de espera. El parámetro NodeCount contiene el número de nodos de la cadena. La cadena de espera devuelta sigue siendo válida.
ERROR_OBJECT_NOT_FOUND	No se pudo encontrar el subproceso especificado.
ERROR_SUCCESS	La operación se ha completado correctamente.
ERROR_TOO_MANY_THREADS	El número de nodos supera WCT_MAX_NODE_COUNT. La cadena de espera devuelta sigue siendo válida.

NodeCount

Número de nodos recuperados, hasta WCT_MAX_NODE_COUNT. Si la matriz no puede contener todos los nodos de la cadena de espera, se produce un error en la función, CallbackStatus se ERROR_MORE_DATA y este parámetro recibe el número de elementos de matriz necesarios para contener todos los nodos.

NodeInfoArray

Matriz de estructuras de WAITCHAIN_NODE_INFO que recibe la cadena de espera.

IsCycle

Si la función detecta un interbloqueo, esta variable se establece en TRUE; de lo contrario, se establece en FALSE.

Valor devuelto

None

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wct.h

Consulte también

GetThreadWaitChain

OpenThreadWaitChainSession

WAITCHAIN_NODE_INFO