Méthode IDebugControl ::GetWindbgExtensionApis64 (dbgeng.h)

  • Article

La méthode GetWindbgExtensionApis64 retourne une structure qui facilite l’utilisation de l’API WdbgExts.

Syntaxe

HRESULT GetWindbgExtensionApis64(
  [in, out] PWINDBG_EXTENSION_APIS64 Api
);

Paramètres

[in, out] Api

Reçoit une structure WINDBG_EXTENSION_APIS64. Cette structure contient les fonctions utilisées par l’API WdbgExts. Le membre nSize de cette structure doit être défini sur la taille de la structure avant d’être passé à cette méthode.

Valeur retournée

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

Code de retour Description
S_OK
 La méthode a réussi.
E_INVALIDARG
 La valeur d’Api->nSize n’est pas égale à la taille de la structure WINDBG_EXTENSION_APIS64.

Remarques

Si vous incluez Wdbgexts.h dans votre code d’extension, vous devez appeler cette méthode lors de l’initialisation de la DLL d’extension (voir DebugExtensionInitialize).

De nombreuses fonctions WdbgExts sont en fait des macros. Pour vous assurer que ces macros fonctionnent correctement, la structure reçue par le paramètre Api doit être stockée dans une variable globale nommée ExtensionApis.

La structure WINDBG_EXTENSION_APIS64 retournée par cette méthode a le même objectif que celle fournie à la fonction de rappel WinDbgExtensionDllInit (utilisée par les extensions WdbgExts).

Pour obtenir la liste des fonctions fournies par l’API WdbgExts, consultez Fonctions WdbgExts.

Configuration requise

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