PPUT_SCATTER_GATHER_LIST fungsi panggilan balik (wdm.h)

Artikel
02/29/2024

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)

Lihat juga