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

Article
02/06/2025

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 dans la mémoire de l’ordinateur cible de la variable à lire.

[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 tampon. Il s’agit du nombre maximal d’octets qui seront lus.

[out, optional] BytesRead

Reçoit le nombre d’octets lus. Si BytesRead est NULL, ces informations ne sont pas retournées.

Valeur de retour

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la mémoire tampon 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 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.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Partager via