IDebugClient5::AttachKernel, méthode (dbgeng.h)

Les méthodes AttachKernel connectent le moteur du débogueur à une cible de noyau.

Syntaxe

HRESULT AttachKernel(
  [in]           ULONG Flags,
  [in, optional] PCSTR ConnectOptions
);

Paramètres

[in] Flags

Spécifie les indicateurs qui contrôlent la façon dont le débogueur s’attache à la cible du noyau. Les valeurs possibles sont les suivantes :

Valeur Description
DEBUG_ATTACH_KERNEL_CONNECTION Attachez le noyau sur l’ordinateur cible.
DEBUG_ATTACH_EXDI_DRIVER Attachez-vous à un noyau à l’aide d’un pilote eXDI.

[in, optional] ConnectOptions

Spécifie les paramètres de connexion pour communiquer avec l’ordinateur exécutant la cible du noyau. L’interprétation de ConnectOptions dépend de la valeur des indicateurs.

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions sera interprété de la même façon que les options qui suivent le commutateur -k sur les lignes de commande WinDbg et KD. Les variables d’environnement affectent ConnectOptions de la même façon qu’elles affectent le commutateur -k .

DEBUG_ATTACH_EXDI_DRIVER

Les pilotes eXDI ne sont pas décrits dans cette documentation. Si vous disposez d’une interface eXDI pour votre sonde matérielle ou simulateur matériel, contactez Microsoft pour obtenir des informations de débogage.

Valeur de retour

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

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

Remarques

Note Le moteur n’est pas complètement attaché au noyau tant que la méthode WaitForEvent n’a pas été appelée. Une fois que le noyau a généré un événement (par exemple, le point d’arrêt initial), il devient disponible dans la session du débogueur.
 
Pour plus d’informations sur la connexion à des cibles en mode noyau dynamique, consultez Cibles live Kernel-Mode.

Configuration requise

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (include Dbgeng.h)

Voir aussi

AttachProcess

GetKernelConnectionOptions

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IsKernelDebuggerEnabled