WAITCHAIN_NODE_INFO structure (wct.h)

Article
09/01/2022

Represents a node in a wait chain.

Syntax

typedef struct _WAITCHAIN_NODE_INFO {
  WCT_OBJECT_TYPE   ObjectType;
  WCT_OBJECT_STATUS ObjectStatus;
  union {
    struct {
      WCHAR         ObjectName[WCT_OBJNAME_LENGTH];
      LARGE_INTEGER Timeout;
      BOOL          Alertable;
    } LockObject;
    struct {
      DWORD ProcessId;
      DWORD ThreadId;
      DWORD WaitTime;
      DWORD ContextSwitches;
    } ThreadObject;
  };
} WAITCHAIN_NODE_INFO, *PWAITCHAIN_NODE_INFO;

Members

ObjectType

The object type. This member is one of the following values from the WCT_OBJECT_TYPE enumeration type.

WctCriticalSectionType

WctSendMessageType

WctMutexType

WctAlpcType

WctComType

WctThreadWaitType

WctProcessWaitType

WctThreadType

WctComActivationType

WctUnknownType

ObjectStatus

The object status. This member is one of the following values from the WCT_OBJECT_STATUS enumeration type.

WctStatusNoAccess

WctStatusRunning

WctStatusBlocked

WctStatusPidOnly

WctStatusPidOnlyRpcss

WctStatusOwned

WctStatusNotOwned

WctStatusAbandoned

WctStatusUnknown

WctStatusError

LockObject

LockObject.ObjectName[WCT_OBJNAME_LENGTH]

The name of the object. Object names are only available for certain object, such as mutexes. If the object does not have a name, this member is an empty string.

LockObject.Timeout

This member is reserved for future use.

LockObject.Alertable

This member is reserved for future use.

ThreadObject

ThreadObject.ProcessId

The process identifier.

ThreadObject.ThreadId

The thread identifier. For COM and ALPC, this member can be 0.

ThreadObject.WaitTime

The wait time.

ThreadObject.ContextSwitches

The number of context switches.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	wct.h