Edit

Share via

IDebugDataSpaces4::ReadBusData method (dbgeng.h)

  • Article

The ReadBusData method reads data from a system bus.

Syntax

HRESULT ReadBusData(
  [in]            ULONG  BusDataType,
  [in]            ULONG  BusNumber,
  [in]            ULONG  SlotNumber,
  [in]            ULONG  Offset,
  [out]           PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG BytesRead
);

Parameters

[in] BusDataType

Specifies the bus data type to read from. For details of allowed values see the documentation for the BUS_DATA_TYPE enumeration in the Microsoft Windows SDK.

[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 bus data type.

[in] SlotNumber

Specifies the logical slot number on the bus.

[in] Offset

Specifies the offset in the bus data to start reading from.

[out] Buffer

Receives the data from the bus.

[in] BufferSize

Specifies the size in bytes of the buffer Buffer. This is the maximum number of bytes that will be returned.

[out, optional] BytesRead

Receives the number of bytes read from the 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.

The nature of the data read from the bus is system, bus, and slot dependent.

Requirements

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