Edit

Share via

IDebugDataSpaces4::ReadIo method (dbgeng.h)

  • Article

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

Syntax

HRESULT ReadIo(
  [in]            ULONG   InterfaceType,
  [in]            ULONG   BusNumber,
  [in]            ULONG   AddressSpace,
  [in]            ULONG64 Offset,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Parameters

[in] InterfaceType

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

[in] 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.

[in] AddressSpace

This parameter must be equal to one.

[in] Offset

Specifies the I/O address within the address space.

[out] Buffer

Receives the data read from the I/O bus.

[in] 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.

[out, optional] BytesRead

Receives the number of bytes returned read from the I/O bus. If BytesRead is NULL, this information is not returned.

Return value

Return code Description
S_OK
 The method was successful.
 

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

Remarks

This method is only available in kernel-mode debugging.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)