Fungsi StorPortGetBusData (storport.h)
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | storport.h (termasuk Storport.h) |
Pustaka | Storport.lib |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk