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

OpenThreadWaitChainSession 함수에서 만든 WCT 세션에 대한 핸들입니다.

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로 설정됩니다.

반환 값

없음

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wct.h

추가 정보

GetThreadWaitChain

OpenThreadWaitChainSession

WAITCHAIN_NODE_INFO