Fungsi StorPortGetScatterGatherList (storport.h)
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 .
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | storport.h (termasuk Storport.h) |
Pustaka | Storport.lib |