Функция обратного вызова PWAITCHAINCALLBACK (wct.h)

Статья
03/13/2024

Определяемая приложением функция обратного вызова, которая получает цепочку ожидания. Укажите этот адрес при вызове функции OpenThreadWaitChainSession .

Тип PWAITCHAINCALLBACK определяет указатель на эту функцию обратного вызова. WaitChainCallback — это заполнитель для имени функции, определяемой приложением.

Синтаксис

PWAITCHAINCALLBACK Pwaitchaincallback;

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

Параметры

WctHandle

Дескриптор сеанса WCT, созданного функцией OpenThreadWaitChainSession .

Context

Необязательный указатель на определяемую приложением контекстную структуру, заданную функцией GetThreadWaitChain .

CallbackStatus

Состояние обратного вызова. Этот параметр может быть одним из следующих значений или одним из других кодов системных ошибок.

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающий объект не имеет достаточных прав для открытия целевого потока.
ERROR_CANCELLED	Асинхронный сеанс был отменен вызовом функции CloseThreadWaitChainSession .
ERROR_MORE_DATA	Буфер NodeInfoArray недостаточно велик, чтобы содержать все узлы в цепочке ожидания. Параметр NodeCount содержит количество узлов в цепочке. Возвращаемая цепочка ожидания по-прежнему действительна.
ERROR_OBJECT_NOT_FOUND	Не удалось найти указанный поток.
ERROR_SUCCESS	Операция выполнена успешно.
ERROR_TOO_MANY_THREADS	Количество узлов превышает WCT_MAX_NODE_COUNT. Возвращаемая цепочка ожидания по-прежнему действительна.

NodeCount

Количество полученных узлов( до WCT_MAX_NODE_COUNT). Если массив не может содержать все узлы цепочки ожидания, функция завершается сбоем, CallbackStatus ERROR_MORE_DATA, и этот параметр получает количество элементов массива, необходимых для размещения всех узлов.

NodeInfoArray

Массив WAITCHAIN_NODE_INFO структур, получающих цепочку ожидания.

IsCycle

Если функция обнаруживает взаимоблокировку, этой переменной присваивается значение TRUE; В противном случае устанавливается значение FALSE.

Возвращаемое значение

None

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wct.h

См. также раздел

GetThreadWaitChain

OpenThreadWaitChainSession

WAITCHAIN_NODE_INFO

Поделиться через