Reads configuration data from PCI space.

ULONG RtGetBusDataByOffset(
    BUS_DATA_TYPE BusDataType,
    ULONG BusNumber,
    ULONG SlotNumber,
    PVOID pBuffer,
    ULONG Offset,
    ULONG Length
);

Parameters

BusDataType

Type of bus data to retrieve. Currently, its value must be PCIConfiguration.

BusNumber

Zero-based number of the bus in the system.

SlotNumber

Logical slot number.

pBuffer

Pointer to a caller-supplied buffer that receives configuration data. Since currently only PCI configuration data can be obtained, the buffer contains all or part of the PCI_COMMON_CONFIG data type.

Offset

Offset in PCI_COMMON_CONFIG to start reading from.

Length

Number of bytes to read.

Remarks

Only PCI configuration data is available.

Return Values

The number of bytes actually read. Special values include:

0 (zero)

The specified PCI bus does not exist.

2

The specified PCI bus exists, but the given slot has no device. The only value returned in the PCI_COMMON_CONFIG structure is the value PCI_INVALID_VENDOR_ID in the VendorID.

Requirements

Notes

• This function operates in the Windows portion of your application.
• The iwin32 API also includes an RtGetBusDataByOffset function that operates in the real-time portion of your application.

See Also

RtSetBusDataByOffset, RtTranslateBusAddress, iwin32x API, iwin32 Overview