Méthode IDebugClient3 ::AttachKernel (dbgeng.h)

Article
02/23/2024

Les méthodes AttachKernel connectent le moteur du débogueur à une cible du 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-vous au 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 la communication 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 est 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 votre simulateur matériel, contactez Microsoft pour obtenir des informations de débogage.

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.

Remarques

Note Le moteur ne s’attache pas complètement au noyau tant que la méthode WaitForEvent n’a pas été appelée. Ce n’est qu’une fois que le noyau a généré un événement (par exemple, le point d’arrêt initial) qu’il devient disponible dans la session du débogueur.

Pour plus d’informations sur la connexion à des cibles en mode noyau actif, consultez Cibles de Kernel-Mode en direct.