Share via

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

  • Статья

Определяемая приложением функция обратного вызова, которая получает цепочку ожидания. Укажите этот адрес при вызове функции 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