WDBGEXTS_THREAD_OS_INFO structure (wdbgexts.h)

Article
08/08/2023

L’opération Ioctl IG_GET_THREAD_OS_INFO retourne des informations sur un thread de système d’exploitation dans la cible. Lorsque vous appelez Ioctl avec IoctlType défini sur IG_GET_THREAD_OS_INFO, IpvData doit contenir un instance de la structure WDBGEXTS_THREAD_OS_INFO.

Syntaxe

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;

Membres

ThreadId

Spécifie l’ID de thread du système d’exploitation (dans le processus actuel) pour le thread dont les informations sont demandées.

ExitStatus

Reçoit le code de sortie du thread. Si le thread est toujours en cours d’exécution ou si le code de sortie n’est pas connu, ExitStatus est défini sur STILL_ACTIVE.

PriorityClass

Reçoit la classe de priorité du thread. Les classes de priorité sont définies par les constantes XXX_PRIORITY_CLASS dans WinBase.h. Pour plus d’informations sur les classes de priorité de thread, consultez le Kit de développement logiciel (SDK) de plateforme. Si la classe de priorité n’est pas connu, PriorityClass est défini sur zéro.

Priority

Reçoit la priorité du thread par rapport à la classe de priorité. Certaines priorités de thread sont définies par les constantes THREAD_PRIORITY_XXX dans WinBase.h. Pour plus d’informations sur les priorités des threads, consultez le Kit de développement logiciel (SDK) de plateforme. Si la priorité n’est pas connue, la priorité est définie sur THREAD_PRIORITY_NORMAL.

CreateTime

Reçoit l’heure de création du thread.

ExitTime

Reçoit l’heure de sortie du thread. Si le thread n’est pas arrêté, ExitTime n’est pas défini.

KernelTime

Reçoit la durée d’exécution du thread en mode noyau.

UserTime

Reçoit la durée d’exécution du thread en mode utilisateur.

StartOffset

Reçoit l’adresse de départ du thread. Si l’adresse de départ n’est pas connue, StartOffset est défini sur zéro.

Affinity

Reçoit le masque d’affinité de thread pour le thread dans un ordinateur multiprocesseur symétrique (SMP). Pour plus d’informations sur le masque d’affinité de thread, consultez le Kit de développement logiciel (SDK) de plateforme. Si le masque d’affinité n’est pas connu, l’affinité est définie sur zéro.

Remarques

Les paramètres de l’opération ioctl IG_GET_THREAD_OS_INFO sont les membres de la structure WDBGEXTS_THREAD_OS_INFO.

Configuration requise

Condition requise	Valeur
En-tête	wdbgexts.h (inclure Wdbgexts.h, Dbgeng.h)

Voir aussi

Ioctl

Partager via