IDebugDataSpaces2::FillPhysical method

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.

Syntax


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

Parameters

Start [in]

Specifies the location in the target's physical memory at which to start writing the pattern.

Size [in]

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

Pattern [in]

Specifies the pattern to write.

PatternSize [in]

Specifies the size in bytes of the pattern.

Filled [out, optional]

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 codeDescription
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

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugDataSpaces2
IDebugDataSpaces3
IDebugDataSpaces4
WritePhysical

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft