ReadIo

The ReadIo method reads from the system and bus I/O memory.

HRESULT
  IDebugDataSpaces::ReadIo(
    IN ULONG  InterfaceType,
    IN ULONG  BusNumber,
    IN ULONG  AddressSpace,
    IN ULONG64  Offset,
    OUT PVOID  Buffer,
    IN ULONG  BufferSize,
    OUT OPTIONAL PULONG  BytesRead
    );

Parameters

InterfaceType

Specifies the interface type of the I/O bus. This parameter may take values in the INTERFACE_TYPE enumeration defined in wdm.h.

BusNumber

Specifies the system-assigned number of the bus. This is usually zero, unless the system has more than one bus of the same interface type.

AddressSpace

This parameter must be equal to one.

Offset

Specifies the I/O address within the address space.

Buffer

Receives the data read from the I/O bus.

BufferSize

Specifies the size in bytes of the buffer Buffer. This is the maximum number of bytes that will be read. At present, this must be 1, 2, or 4.

BytesRead

Receives the number of bytes returned read from the I/O bus. 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

ReadIo 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.