Fungsi StorPortPutScatterGatherList (storport.h)
Rutinitas StorPortPutScatterGatherList merilis sumber daya apa pun yang terkait dengan daftar sebar/kumpulkan yang sebelumnya dibuat oleh panggilan ke rutinitas StorPortBuildScatterGatherList .
Sintaks
ULONG StorPortPutScatterGatherList(
[in] PVOID HwDeviceExtension,
[in] PSTOR_SCATTER_GATHER_LIST ScatterGatherList,
[in] BOOLEAN WriteToDevice
);
Parameter
[in] HwDeviceExtension
Penunjuk ke ekstensi perangkat keras untuk adaptor bus host (HBA).
[in] ScatterGatherList
Penunjuk ke buffer yang berisi daftar sebar/kumpulkan yang sebelumnya dibuat oleh panggilan ke rutinitas StorPortBuildScatterGatherList .
[in] WriteToDevice
Nilai yang menunjukkan arah transfer DMA yang telah selesai. Nilai TRUE menunjukkan transfer dari buffer data ke perangkat, dan FALSE menunjukkan transfer dari perangkat ke buffer data.
Nilai kembali
StorPortPutScatterGatherList mengembalikan salah satu kode status berikut:
Menampilkan kode | Deskripsi |
---|---|
|
Fungsi ini tidak diimplementasikan pada sistem operasi aktif. |
|
Menunjukkan bahwa rutinitas berhasil merilis daftar sebar/kumpulkan. |
|
HwDeviceExtension yang diteruskan adalah NULL. |
|
Panggilan dilakukan pada IRQL yang tidak valid. |
Keterangan
Rutinitas StorPortPutScatterGatherList tidak membebaskan memori buffer untuk daftar sebar/kumpulkan, karena driver miniport mengalokasikan memori ini.
Setelah rutinitas StorPortPutScatterGatherList kembali, driver miniport dapat menggunakan kembali buffer untuk membuat daftar sebar/kumpulkan baru dengan memanggil StorPortBuildScatterGatherList lagi. Jika driver miniport telah selesai menggunakan buffer untuk daftar sebar/kumpulkan, itu harus membebaskan memori untuk buffer setelah rutinitas StorPortPutScatterGatherList kembali. Jika driver miniport mengalokasikan memori buffer dengan rutinitas StorPortAllocatePool , driver miniport harus membebaskan memori dengan memanggil rutinitas StorPortFreePool .
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | storport.h (termasuk Storport.h) |
IRQL | DISPATCH_LEVEL |
Aturan kepatuhan DDI | StorPortIrql(storport) |