PDEBUG_EXTENSION_PROVIDE_VALUE fonction de rappel (dbgeng.h)

Article
02/06/2025

La fonction de rappel DebugExtensionProvideValue définit valeurs de pseudo-inscription.

 CALLBACK* PDEBUG_EXTENSION_PROVIDE_VALUE DebugExtensionProvideValue;

Syntaxe

PDEBUG_EXTENSION_PROVIDE_VALUE PdebugExtensionProvideValue;

HRESULT PdebugExtensionProvideValue(
  [in]  PDEBUG_CLIENT Client,
  [in]  ULONG Flags,
  [in]  PCWSTR Name,
  [out] PULONG64 Value,
  [out] PULONG64 TypeModBase,
  [out] PULONG TypeId,
  [out] PULONG TypeFlags
)
{...}

Paramètres

[in] Client

Un client à utiliser si l’extension a besoin de fonctions DbgEng.

[in] Flags

Fournit des indicateurs de comportement. Ce paramètre est actuellement réservé.

[in] Name

Nom de la valeur à retourner. Ce nom peut être l’un des noms dont la fonction DebugExtensionQueryValueNames retournée ou un nom que l’appelant peut déjà connaître.

[out] Value

Pointeur vers la valeur à définir.

[out] TypeModBase

Adresse de départ de base pour client.

[out] TypeId

Pointeur vers l’ID du type de Valeur.

[out] TypeFlags

Paramètre que vous pouvez utiliser pour renvoyer l’un des indicateurs suivants :

Valeur	Signification
DEBUG_EXT_PVTYPE_IS_VALUE	La valeur pointée par Valeur n’est pas un pointeur.
DEBUG_EXT_PVTYPE_IS_POINTER	La valeur pointée par Valeur est une adresse pour un pointeur vers des données du type spécifié par TypeModBase et TypeId.

Valeur de retour

DebugExtensionProvideValue peut retourner l’une des valeurs suivantes :

Retourner le code	Description
S_OK	La fonction a été correctement terminée.

Cette fonction peut également retourner des valeurs d’erreur. Pour plus d’informations sur les valeurs de retour possibles, consultez Valeurs de retour.

Remarques

Le nom spécifié par le paramètre Name doit commencer par $$ et avoir un caractère NULL de fin.

DebugExtensionProvideValue est appelée PDEBUG_EXTENSION_PROVIDE_VALUE dans le fichier d’en-tête Dbgeng.h.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h

Voir aussi

DebugExtensionInitialize

DebugExtensionNotify

DebugExtensionQueryValueNames

DebugExtensionUninitialize

KnownStructOutput

Partager via