IDebugSymbols3::ReadTypedDataPhysical method (dbgeng.h)
The ReadTypedDataPhysical method reads the value of a variable from the target computer's physical memory.
Syntax
HRESULT ReadTypedDataPhysical(
[in] ULONG64 Offset,
[in] ULONG64 Module,
[in] ULONG TypeId,
[out] PVOID Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG BytesRead
);
Parameters
[in] Offset
Specifies the physical address in the target computer's memory of the variable to be read.
[in] Module
Specifies the base address of the module containing the type of the variable.
[in] TypeId
Specifies the type ID of the type of the variable.
[out] Buffer
Receives the data that was read.
[in] BufferSize
Specifies the size in bytes of the buffer Buffer. This is the maximum number of bytes that will be read.
[out, optional] BytesRead
Receives the number of bytes that were read. If BytesRead is NULL, this information is not returned.
Return value
Return code | Description |
---|---|
|
The method was successful. |
|
The method was successful. However, the buffer Buffer was not large enough to hold all the data and it was truncated. |
This method may also return error values. See Return Values for more details.
Remarks
This method is only available in kernel mode debugging.
The number of bytes this method attempts to read is the smaller of the size of the buffer and the size of the variable.
This is a convenience method. The same result can be obtained by calling GetTypeSize and ReadPhysical.
For more information about types, see Types.
Requirements
Requirement | Value |
---|---|
Target Platform | Desktop |
Header | dbgeng.h (include Dbgeng.h) |