Edit

Share via

WDBGEXTS_THREAD_OS_INFO structure (wdbgexts.h)

  • Article

The IG_GET_THREAD_OS_INFO Ioctl operation returns information about an operating system thread in the target. When calling Ioctl with IoctlType set to IG_GET_THREAD_OS_INFO, IpvData should contain an instance of the WDBGEXTS_THREAD_OS_INFO structure.

Syntax

typedef struct _WDBGEXTS_THREAD_OS_INFO {
  ULONG   ThreadId;
  ULONG   ExitStatus;
  ULONG   PriorityClass;
  ULONG   Priority;
  ULONG64 CreateTime;
  ULONG64 ExitTime;
  ULONG64 KernelTime;
  ULONG64 UserTime;
  ULONG64 StartOffset;
  ULONG64 Affinity;
} WDBGEXTS_THREAD_OS_INFO, *PWDBGEXTS_THREAD_OS_INFO;

Members

ThreadId

Specifies the operating system thread ID (within the current process) for the thread whose information is being requested.

ExitStatus

Receives the exit code of the thread. If the thread is still running or the exit code is not known, ExitStatus will be set to STILL_ACTIVE.

PriorityClass

Receives the priority class of the thread. The priority classes are defined by the constants XXX_PRIORITY_CLASS in WinBase.h. See the Platform SDK for more information about thread priority classes. If the priority class is not know, PriorityClass will be set to zero.

Priority

Receives the priority of the thread relative to the priority class. Some thread priorities are defined by the constants THREAD_PRIORITY_XXX in WinBase.h. See the Platform SDK for more information about thread priorities. If the priority is not known, Priority will be set to THREAD_PRIORITY_NORMAL.

CreateTime

Receives the creation time of the thread.

ExitTime

Receives the exit time of the thread. If the thread has not exited, ExitTime is undefined.

KernelTime

Receives the amount of time that the thread has executed in kernel mode.

UserTime

Receives the amount of time that the thread has executed in user-mode.

StartOffset

Receives the starting address of the thread. If the starting address is not known, StartOffset will be set to zero.

Affinity

Receives the thread affinity mask for the thread in a symmetric multiprocessor (SMP) computer. See the Platform SDK for more information about the thread affinity mask. If the affinity mask is not known, Affinity is set to zero.

Remarks

The parameters for the IG_GET_THREAD_OS_INFO Ioctl operation are the members of the WDBGEXTS_THREAD_OS_INFO structure.

Requirements

Requirement Value
Header wdbgexts.h (include Wdbgexts.h, Dbgeng.h)

See also

Ioctl