Méthode IDebugDataSpaces4 ::FillVirtual (dbgeng.h)

Article
02/23/2024

La méthode FillVirtual écrit un modèle d’octets dans la mémoire virtuelle de la cible. Le modèle est écrit à plusieurs reprises jusqu’à ce que la plage de mémoire spécifiée soit remplie.

Syntaxe

HRESULT FillVirtual(
  [in]            ULONG64 Start,
  [in]            ULONG   Size,
  [in]            PVOID   Pattern,
  [in]            ULONG   PatternSize,
  [out, optional] PULONG  Filled
);

Paramètres

[in] Start

Spécifie l’emplacement dans l’espace d’adressage virtuel de la cible à partir duquel commencer à écrire le modèle.

[in] Size

Spécifie le nombre d’octets à écrire dans la mémoire de la cible.

[in] Pattern

Spécifie l’emplacement de mémoire du modèle.

[in] PatternSize

Spécifie la taille en octets du modèle.

[out, optional] Filled

Reçoit le nombre d’octets écrits. Si elle est définie sur 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.

Remarques

Cette méthode écrit le modèle dans la mémoire de la cible autant de fois qu’il convient dans Size octets.

Si la copie finale du modèle ne tient pas complètement dans la plage de mémoire, elle n’est que partiellement écrite. Cela inclut le cas où la taille du modèle est supérieure à la valeur de Size et où les octets supplémentaires dans le modèle sont ignorés.