IDebugDataSpaces3::FillVirtual-Methode (dbgeng.h)

Artikel
02/06/2025

Die FillVirtual--Methode schreibt ein Bytemuster in den virtuellen Speicher des Ziels. Das Muster wird wiederholt geschrieben, bis der angegebene Speicherbereich gefüllt ist.

Syntax

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

Parameter

[in] Start

Gibt den Speicherort im virtuellen Adressbereich des Ziels an, an dem das Muster geschrieben werden soll.

[in] Size

Gibt an, wie viele Bytes in den Speicher des Ziels geschrieben werden sollen.

[in] Pattern

Gibt den Speicherort des Musters an.

[in] PatternSize

Gibt die Größe in Byte des Musters an.

[out, optional] Filled

Empfängt die Anzahl der geschriebenen Bytes. Wenn sie auf NULL-festgelegt ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Diese Methode schreibt das Muster so oft in den Speicher des Ziels, wie es in Größe Bytes passt.

Wenn die endgültige Kopie des Musters nicht vollständig in den Speicherbereich passt, wird es nur teilweise geschrieben. Dies schließt den Fall ein, in dem die Größe des Musters größer als der Wert Sizeist und die zusätzlichen Bytes im Muster ignoriert werden.