ReadBusData

The ReadBusData method reads data from a system bus.

HRESULT
  IDebugDataSpaces::ReadBusData(
    IN ULONG  BusDataType,
    IN ULONG  BusNumber,
    IN ULONG  SlotNumber,
    IN ULONG  Offset,
    OUT PVOID  Buffer,
    IN ULONG  BufferSize,
    OUT OPTIONAL PULONG  BytesRead
    );

Parameters

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.

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.

SlotNumber

Specifies the logical slot number on the bus.

Offset

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

Buffer

Receives the data from the bus.

BufferSize

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

BytesRead

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

ReadBusData is available in all versions of IDebugDataSpaces.

Comments

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

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