Méthode IDebugSymbols2 ::WriteTypedDataPhysical (dbgeng.h)

Article
02/23/2024

La méthode WriteTypedDataPhysical écrit la valeur d’une variable dans la mémoire physique de l’ordinateur cible.

Syntaxe

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

Paramètres

[in] Offset

Spécifie l’adresse physique dans la mémoire de l’ordinateur cible de la variable.

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

[in] Buffer

Spécifie la mémoire tampon contenant les données à écrire.

[in] BufferSize

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

[out, optional] BytesWritten

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

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Tous les octets de la mémoire tampon ont été écrits. Toutefois, la mémoire tampon était inférieure à la taille du type spécifié.

Remarques

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

Le nombre d’octets que cette méthode tente d’écrire 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 WritePhysical.

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)