Fungsi StorPortGetBusData (storport.h)

Artikel
08/07/2023

Rutinitas StorPortGetBusData mengambil informasi konfigurasi khusus bus yang diperlukan untuk menginisialisasi HBA.

Sintaks

STORPORT_API ULONG StorPortGetBusData(
  [in]      PVOID DeviceExtension,
  [in]      ULONG BusDataType,
  [in]      ULONG SystemIoBusNumber,
  [in]      ULONG SlotNumber,
  [in, out] PVOID Buffer,
  [in]      ULONG Length
);

Parameter

[in] DeviceExtension

Arahkan ke area penyimpanan per HBA driver miniport.

[in] BusDataType

Berisi nilai jenis BUS_DATA_TYPE yang menentukan jenis data konfigurasi khusus bus yang akan dikembalikan. Saat ini, nilai ini bisa menjadi salah satu dari yang berikut: Cmos, EisaConfiguration, Pos, atau PCIConfiguration. Namun, jenis konfigurasi bus tambahan akan didukung di masa mendatang. Batas atas pada jenis yang didukung selalu MaximumBusDataType.

[in] SystemIoBusNumber

Menentukan nomor bus I/O yang ditetapkan sistem. Rutinitas HwStorFindAdapter driver miniport mendapatkan nilai ini dari anggota SystemIoBusNumber yang awalnya ditetapkan dalam PORT_CONFIGURATION_INFORMATION.

[in] SlotNumber

Menentukan nomor slot logis atau lokasi perangkat.

Jika PCIConfiguration ditentukan sebagai BusDataType, parameter ini harus ditentukan sebagai nilai jenis PCI_SLOT_NUMBER.

[in, out] Buffer

Penunjuk ke buffer atau area tempat data konfigurasi dikembalikan atau, jika Panjang yang diberikan adalah nol, menunjuk ke lokasi di mana driver port khusus OS mengembalikan pointer ke buffer yang dialokasikannya.

[in] Length

Menentukan jumlah maksimum byte yang akan dikembalikan di Buffer, atau nol jika pemanggil memerlukan driver port khusus OS untuk mengalokasikan buffer untuk berisi data.

Nilai kembali

StorPortGetBusData mengembalikan jumlah byte informasi konfigurasi yang disimpannya dalam buffer. Ketika input BusDataType adalah PCIConfiguration, StorPortGetBusData dapat mengembalikan salah satu nilai berikut untuk menunjukkan kesalahan.

Menampilkan kode	Deskripsi
0 (zero)	Bus PCI tidak ada.
2	Bus PCI ada, tetapi tidak ada perangkat di SlotNumber PCI yang diberikan. Buffer berisi nilai yang PCI_INVALID_VENDOR_ID pada anggota PCI_COMMON_CONFIG VendorId.

Keterangan

Driver miniport dapat memanggil StorPortGetBusData dari rutinitas berikut:

Dari rutinitas panggilan balik HwStorFindAdapter .
Dari HwStorAdapterControl hanya ketika ControlType adalah ScsiSetRunningConfig.

Panggilan dari rutinitas driver miniport lainnya akan mengakibatkan kegagalan sistem atau operasi yang salah untuk pemanggil.

Data konfigurasi yang dikembalikan oleh StorPortGetBusData hanya valid hingga driver miniport memanggil StorPortGetBusData lagi. Segera setelah rutinitas HwStorFindAdapter pemanggil mengembalikan kontrol, data konfigurasi yang dikembalikan menjadi tidak valid.