Fungsi StorPortGetScatterGatherList (storport.h)

Artikel
08/07/2023

Rutinitas StorPortGetScatterGatherList mengambil daftar sebar/kumpulkan terkait untuk blok permintaan SCSI (SRB) yang ditentukan.

Sintaks

STORPORT_API PSTOR_SCATTER_GATHER_LIST StorPortGetScatterGatherList(
  [in] PVOID               HwDeviceExtension,
  [in] PSCSI_REQUEST_BLOCK Srb
);

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat keras. Ini adalah area penyimpanan per HBA yang dialokasikan dan diinisialisasi driver port atas nama driver miniport. Driver Miniport biasanya menyimpan informasi khusus HBA dalam ekstensi ini, seperti status HBA dan rentang akses yang dipetakan untuk HBA. Area ini tersedia untuk miniport segera setelah driver miniport memanggil StorPortInitialize. Pengandar porta membebaskan memori ini ketika melepas perangkat.

[in] Srb

Penunjuk ke SRB tempat daftar pengumpulan sebar akan dibangun.

Nilai kembali

StorPortGetScatterGatherList mengembalikan pointer ke daftar sebar/kumpulkan.

Keterangan

Rutinitas ini disediakan dengan pustaka driver Storport. Tidak ada rutinitas paralel yang disediakan di pustaka port SCSI.

Penunjuk ke daftar sebar/kumpulkan yang dikembalikan hanya valid hingga SRB selesai.

Driver miniport tidak harus membebaskan memori untuk daftar sebar/kumpulkan yang dikembalikan StorPortGetScatterGatherList .

Driver miniport tidak boleh mengubah daftar sebar/kumpulkan.

Mulai dari Windows 8, parameter Srb dapat menunjuk ke SCSI_REQUEST_BLOCK atau STORAGE_REQUEST_BLOCK. Jika pengidentifikasi fungsi di bidang FungsiSrbSRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB adalah struktur permintaan STORAGE_REQUEST_BLOCK .