IDebugDataSpaces2::FillPhysical-Methode (dbgeng.h)

Artikel
02/23/2024

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

Syntax

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

Parameter

[in] Start

Gibt den Speicherort im physischen Arbeitsspeicher 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 das zu schreibende Muster an.

[in] PatternSize

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

Mit dieser Methode wird das Muster so oft in den Arbeitsspeicher des Ziels geschrieben, wie in Größenbytes 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.