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

Article
02/06/2025

Les méthodes attachKernel connectent le moteur de 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-vous au noyau sur l’ordinateur cible.
DEBUG_ATTACH_EXDI_DRIVER	Attacher à 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 de Flags.

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions sera interprétée 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 de retour.

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

Remarque Le moteur n’est pas entièrement 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) 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.