Méthode IDebugSymbols ::ReadTypedDataVirtual (dbgeng.h)

Article
02/23/2024

La méthode ReadTypedDataVirtual lit la valeur d’une variable dans la mémoire virtuelle de la cible.

Syntaxe

HRESULT ReadTypedDataVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG64 Module,
  [in]            ULONG   TypeId,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Paramètres

[in] Offset

Spécifie l’emplacement de la variable à lire dans l’espace d’adressage virtuel de la cible.

[in] Module

Spécifie l’adresse de base du module contenant le type de la variable.

[in] TypeId

Spécifie l’ID de type du type.

[out] Buffer

Reçoit les données lues.

[in] BufferSize

Spécifie la taille en octets de la mémoire tampon. Il s’agit du nombre maximal d’octets à lire.

[out, optional] BytesRead

Reçoit le nombre d’octets qui ont été lus. Si BytesRead a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Code de retour	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la mémoire tampon n’était pas assez grande pour contenir toutes les données et elle a été tronquée.

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

Remarques

Le nombre d’octets que cette méthode tente de lire est le plus petit de la taille de la mémoire tampon et de la taille de la variable.

Il s’agit d’une méthode pratique. Le même résultat peut être obtenu en appelant GetTypeSize et ReadVirtual.

Pour plus d’informations sur les types, consultez Types.

Configuration requise

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

Partager via