IDebugDataSpaces2::FillVirtual method (dbgeng.h)

Article
02/22/2024

The FillVirtual method writes a pattern of bytes to the target's virtual memory. The pattern is written repeatedly until the specified memory range is filled.

Syntax

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

Parameters

[in] Start

Specifies the location in the target's virtual address space at which to start writing the pattern.

[in] Size

Specifies how many bytes to write to the target's memory.

[in] Pattern

Specifies the memory location of the pattern.

[in] PatternSize

Specifies the size in bytes of the pattern.

[out, optional] Filled

Receives the number of bytes written. If it is set to NULL, this information isn't returned.

Return value

This method can also return error values. See Return Values for more details.

Return code	Description
S_OK	The method was successful.

Remarks

This method writes the pattern to the target's memory as many times as will fit in Size bytes.

If the final copy of the pattern will not completely fit into the memory range, it will only be partially written. This includes the case where the size of the pattern is larger than the value of Size, and the extra bytes in the pattern are ignored.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)