Debugging Tools for Windows

FillPhysical

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

HRESULT
  IDebugDataSpaces2::FillPhysical(
    IN ULONG64  Start,
    IN ULONG  Size,
    IN PVOID  Pattern,
    IN ULONG  PatternSize,
    OUT OPTIONAL PULONG  Filled
    );

Parameters

Start
Specifies the location in the target's physical memory at which to start writing the pattern.
Size
Specifies how many bytes to write to the target's memory.
Pattern
Specifies the pattern to write.
PatternSize
Specifies the size in bytes of the pattern.
Filled
Receives the number of bytes written. If it is set to NULL, this information isn't returned.

Return Value

S_OK
The method was successful.

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

Interface Version

FillPhysical is available in IDebugDataSpaces2 and later versions.

Comments

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

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

WritePhysical

Build machine: CAPEBUILD