ScsiPortGetBusData

ULONG ScsiPortGetBusData(DeviceExtension, BusDataType, SystemIoBusNumber,
    Slotnumber, Buffer, Length)
IN PVOID  DeviceExtension;
IN ULONG  BusDataType;
IN ULONG  SystemIoBusNumber;
IN ULONG  SlotNumber;
IN PVOID  Buffer;
IN ULONG  Length;
 

Gets bus-type-specific information.

• Returns the number of bytes that were actually returned.

DeviceExtension

Points to the HBA miniport driver's storage for per-adapter data.

BusDataType

Specifies the type of bus-specific data. Recognized information comes from CMOS, EISA, POS, CBUS, PCIC, and VME sources.

SystemIoBusNumber

Specifies which of the buses of the same type should be addressed. This value can be retrieved from the PORT_CONFIGURATION_INFORMATION structure.

SlotNumber

Specifies the slot to be accessed.

Buffer

Specifies where the retrieved data should be stored.

Length

Specifies the amount of data to retrieved.

This function can be called only from a miniport driver's HwFindAdapter routine. Calls to ScsiPortGetBusData from other miniport driver functions will result in system failure or an incorrect operation.

If Length is zero, the buffer is treated as a pointer to where the pointer to the buffer should be stored. The port driver will allocate a buffer for the data. The pointer to this buffer is returned in the location pointed to by Buffer. This data is valid only until this function is called again or HwFindAdapter returns.

In the case of the PCI bus, you can also access its configuration space using CONFIGMG_Call_Enumerator_Function. See KB article Q140730 (Accessing PCI Device's Configuration Space from Device Driver).

See Also

PORT_CONFIGURATION_INFORMATION, HwFindAdapter