IDebugSymbols3 ::ReadTypedDataPhysical, méthode (dbgeng.h)

Article
02/26/2024

La méthode ReadTypedDataPhysical lit la valeur d’une variable à partir de la mémoire physique de l’ordinateur cible.

Syntaxe

HRESULT ReadTypedDataPhysical(
  [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’adresse physique de la variable à lire dans la mémoire de l’ordinateur 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 de la variable.

[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 qui seront lus.

[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

Cette méthode n’est disponible que dans le débogage en mode noyau.

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 ReadPhysical.

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)