IDebugControl7 ::GetDebuggeeType2, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetDebuggeeType2 décrit la nature de la cible actuelle.

Syntaxe

HRESULT GetDebuggeeType2(
  [in]  ULONG  Flags,
  [out] PULONG Class,
  [out] PULONG Qualifier
);

Paramètres

[in] Flags

Prend un indicateur unique, DEBUG_EXEC_FLAGS_NONBLOCK, qui indique si la fonction GetDebuggeeType2 doit posséder l’objet de section critique du moteur (g_EngineLock) avant de trouver le type de débogage.

Si l’indicateur est présent, la fonction essaie de posséder la section critique. En cas d’échec, il continue sans bloquer le thread de l’appelant.

Si l’indicateur n’est pas passé, la fonction attend que la section critique du moteur soit disponible avant de continuer.

[out] Class

Reçoit la classe de la cible actuelle. Elle est définie sur l’une des valeurs du tableau suivant.

Valeur	Description
DEBUG_CLASS_UNINITIALIZED	Il n’y a pas de cible actuelle.
DEBUG_CLASS_KERNEL	La cible actuelle est une cible en mode noyau.
DEBUG_CLASS_USER_WINDOWS	La cible actuelle est une cible en mode utilisateur.

[out] Qualifier

Fournit plus d’informations sur le type de la cible. Son interprétation dépend de la valeur de classe. Lorsque la classe est DEBUG_CLASS_UNINITIALIZED, qualificateur retourne zéro. Les valeurs suivantes s’appliquent aux cibles en mode noyau.

Valeur	Description
DEBUG_KERNEL_CONNECTION	La cible actuelle est un noyau actif débogué de la manière standard (à l’aide d’un port COM, d’un bus 1394 ou d’un canal nommé).
DEBUG_KERNEL_LOCAL	La cible actuelle est le noyau local.
DEBUG_KERNEL_EXDI_DRIVER	La cible actuelle est un noyau actif connecté à l’aide de pilotes eXDI.
DEBUG_KERNEL_SMALL_DUMP	La cible actuelle est un fichier de vidage de mémoire de petite mémoire en mode noyau.
DEBUG_KERNEL_DUMP	La cible actuelle est un fichier de vidage mémoire du noyau en mode noyau.
DEBUG_KERNEL_FULL_DUMP	La cible actuelle est un fichier de vidage de mémoire complète en mode noyau.

Les valeurs suivantes s’appliquent aux cibles en mode utilisateur.

Valeur	Description
DEBUG_USER_WINDOWS_PROCESS	La cible actuelle est un processus en mode utilisateur sur le même ordinateur que le moteur de débogueur .
DEBUG_USER_WINDOWS_PROCESS_SERVER	La cible actuelle est un processus en mode utilisateur connecté à l’aide d’un serveur de processus.
DEBUG_USER_WINDOWS_SMALL_DUMP	La cible actuelle est un fichier Minidump en mode utilisateur.
DEBUG_USER_WINDOWS_DUMP	La cible actuelle est un fichier de vidage complet User-Mode.

Valeur de retour

Cette méthode ne retourne pas de valeur.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h

Voir aussi

IDebugControl7

Partager via