Fungsi ScsiPortSetBusDataByOffset (srb.h)

Artikel
02/26/2024

ScsiPortSetBusDataByOffset rutin mengatur data konfigurasi bus untuk adaptor pada bus I/O yang dapat dikonfigurasi secara dinamis dengan antarmuka standar yang diterbitkan.

Catatan Driver port SCSI dan model driver miniport SCSI dapat diubah atau tidak tersedia di masa mendatang. Sebagai gantinya, sebaiknya gunakan driver Storport dan model driver miniport Storport .

Sintaks

SCSIPORT_API ULONG ScsiPortSetBusDataByOffset(
  [in] PVOID DeviceExtension,
  [in] ULONG BusDataType,
  [in] ULONG SystemIoBusNumber,
  [in] ULONG SlotNumber,
  [in] PVOID Buffer,
  [in] ULONG Offset,
  [in] ULONG Length
);

Parameter

[in] DeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

[in] BusDataType

Berisi nilai jenis BUS_DATA_TYPE yang menentukan jenis data bus yang akan diatur. Saat ini, nilainya dapat berupa PCIConfiguration. Namun, jenis bus standar yang dapat dikonfigurasi secara dinamis akan didukung di masa mendatang. Batas atas pada jenis bus yang didukung selalu MaximumBusDataType.

[in] SystemIoBusNumber

Menentukan nomor bus I/O yang ditetapkan sistem tempat HBA terhubung. Rutinitas HwScsiFindAdapter driver miniport mendapatkan nilai ini dari input PORT_CONFIGURATION_INFORMATION anggota SystemIoBusNumber .

[in] SlotNumber

Menentukan nomor slot logis HBA.

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

[in] Buffer

Pointer ke area penyimpanan yang disediakan penelepon dengan informasi konfigurasi khusus untuk BusDataType.

Ketika PCIConfiguration ditentukan, buffer berisi beberapa atau semua informasi PCI_COMMON_CONFIG untuk SlotNumber yang diberikan. Offset dan Panjang yang ditentukan menentukan berapa banyak informasi yang disediakan.

[in] Offset

Menentukan offset byte dalam struktur PCI_COMMON_CONFIG di mana nilai konfigurasi yang disediakan pemanggil dimulai. Driver miniport dapat menggunakan PCI_COMMON_HDR_LENGTH untuk menentukan offset area khusus perangkat di PCI_COMMON_CONFIG.

[in] Length

Menentukan jumlah byte di area penyimpanan di Buffer.

Nilai kembali

ScsiPortSetBusDataByOffset mengembalikan jumlah byte data yang berhasil diatur untuk SlotNumber yang diberikan. Jika BusDataType yang diberikan tidak valid untuk platform saat ini atau jika informasi yang disediakan tidak valid, ScsiPortSetBusDataByOffset mengembalikan nol.

Keterangan

Driver miniport HBA pada bus PCI jarang memanggil ScsiPortSetBusDataByOffset kecuali keadaan yang tidak biasa atau sifat HBA pengemudi tertentu memerlukan panggilan seperti itu. Misalnya, driver miniport mungkin memanggil ScsiPortSetBusDataByOffset untuk menghapus sedikit dalam daftar status PCI jika HBA-nya memberi sinyal pembatalan target selama inisialisasi atau untuk mengatur data konfigurasi khusus perangkat untuk HBA.

ScsiPortSetBusDataByOffset hanya dapat dipanggil dari rutinitas HwScsiFindAdapter driver miniport atau dari HwScsiAdapterControl ketika jenis kontrolnya adalah ScsiSetRunningConfig.