PDEBUG_EXTENSION_PROVIDE_VALUE fonction de rappel (dbgeng.h)

Article
02/23/2024

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

 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

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 que la fonction DebugExtensionQueryValueNames a retournés 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 du client.

[out] TypeId

Pointeur vers l’ID du type Value.

[out] TypeFlags

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

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

Valeur retournée

DebugExtensionProvideValue peut retourner l’une des valeurs suivantes :

Code de retour	Description
S_OK	La fonction s’est terminée avec succès.

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é PDEBUG_EXTENSION_PROVIDE_VALUE dans le fichier d’en-tête Dbgeng.h.

Configuration requise

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

Voir aussi

DebugExtensionInitialize

DebugExtensionNotify

DebugExtensionQueryValueNames

DebugExtensionUninitialize

KnownStructOutput

Partager via