PPUT_SCATTER_GATHER_LIST fungsi panggilan balik (wdm.h)
Rutinitas PutScatterGatherList membebaskan daftar peta yang dialokasikan sebelumnya dan daftar sebar/kumpulkan yang digunakan dalam menyebarkan/mengumpulkan DMA.
Sintaks
PPUT_SCATTER_GATHER_LIST PputScatterGatherList;
void PputScatterGatherList(
[in] PDMA_ADAPTER DmaAdapter,
[in] PSCATTER_GATHER_LIST ScatterGather,
[in] BOOLEAN WriteToDevice
)
{...}
Parameter
[in] DmaAdapter
Penunjuk ke struktur DMA_ADAPTER yang dikembalikan oleh IoGetDmaAdapter yang mewakili adaptor bus-master atau pengontrol DMA.
[in] ScatterGather
Penunjuk ke struktur SCATTER_GATHER_LIST yang sebelumnya dikembalikan oleh GetScatterGatherList.
[in] WriteToDevice
Menunjukkan arah transfer DMA: tentukan TRUE untuk transfer dari buffer ke perangkat, dan FALSE jika tidak.
Nilai kembali
Tidak ada
Keterangan
PutScatterGatherList bukanlah rutinitas sistem yang dapat dipanggil langsung berdasarkan nama. Rutinitas ini hanya dapat dipanggil oleh penunjuk dari alamat yang dikembalikan dalam struktur DMA_OPERATIONS . Driver mendapatkan alamat rutinitas ini dengan memanggil IoGetDmaAdapter.
Driver harus memanggil PutScatterGatherList setelah menyelesaikan I/O sebar/kumpulkan. Rutinitas ini membersihkan buffer adaptor, membebaskan register peta, dan membuka peta dan membebaskan MDL terkait. Selain itu, rutinitas membebaskan daftar sebar/kumpulkan jika sebelumnya dialokasikan oleh GetScatterGatherList.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows 2000 dan versi Windows yang lebih baru. Tidak didukung di Windows 98 atau Windows Me. |
Target Platform | Desktop |
Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
IRQL | DISPATCH_LEVEL |
Aturan kepatuhan DDI | IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |