Debugging Tools for Windows

ReadControl

The ReadControl method reads implementation-specific system data.

HRESULT
  IDebugDataSpaces::ReadControl(
    IN ULONG  Processor,
    IN ULONG64  Offset,
    OUT PVOID  Buffer,
    IN ULONG  BufferSize,
    OUT OPTIONAL PULONG  BytesRead
    );

Parameters

Processor
Specifies the processor whose information is to be read.
Offset
Specifies the offset in the control space of the memory to read.
Buffer
Receives the data read from the control-space memory.
BufferSize
Specifies the size in bytes of the buffer Buffer. This is the maximum number of bytes that will be read.
BytesRead
Receives the number of bytes returned in the buffer Buffer. If BytesRead is NULL, this information is not returned.

Return Value

S_OK
The method was successful.

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

Interface Version

ReadControl is available in all versions of IDebugDataSpaces.

Comments

This method is only available in kernel-mode debugging.

Requirements

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

Build machine: CAPEBUILD