IDebugDataSpaces2::FillVirtual-Methode (dbgeng.h)

Artikel
02/23/2024

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 Adressraum des Ziels an, an dem mit dem Schreiben des Musters begonnen werden soll.

[in] Size

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

[in] Pattern

Gibt den Speicherort des Musters an.

[in] PatternSize

Gibt die Größe des Musters in Byte 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.

Hinweise

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

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