Méthode IDebugControl7 ::GetDebuggeeType2 (dbgeng.h)
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. Si cela échoue, il continue sans bloquer le thread de l’appelant.
Si l’indicateur n’est pas transmis, la fonction attend que la section critique du moteur soit disponible avant de continuer.
[out] Class
Reçoit la classe de la cible actuelle. Il sera défini sur l’une des valeurs du tableau suivant.
| Valeur | Description |
|---|---|
| DEBUG_CLASS_UNINITIALIZED | Il n’existe aucune 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 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 du 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 ne retourne pas de valeur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | dbgeng.h |