IDebugControl ::GetDebuggeeType, méthode (dbgeng.h)

  • Article

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

Syntaxe

HRESULT GetDebuggeeType(
  [out] PULONG Class,
  [out] PULONG Qualifier
);

Paramètres

[out] Class

Reçoit la classe de la cible actuelle. Elle sera 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 de détails sur le type de la cible. Son interprétation dépend de la valeur de Class. Lorsque la classe est DEBUG_CLASS_UNINITIALIZED, le 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 en cours de débogage de 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 taille en mode noyau.
DEBUG_KERNEL_DUMP La cible actuelle est un fichier de vidage de mémoire du noyau en mode noyau.
DEBUG_KERNEL_FULL_DUMP La cible actuelle est un fichier de vidage de mémoire complet 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 full User-Mode Dump.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour Description
S_OK
 La méthode a réussi.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)