Fungsi WdfDmaEnablerSetMaximumScatterGatherElements (wdfdmaenabler.h)

[Hanya berlaku untuk KMDF]

Metode WdfDmaEnablerSetMaximumScatterGatherElements menetapkan jumlah maksimum elemen sebar/kumpulkan yang didukung perangkat, untuk objek pengaktif DMA tertentu.

Sintaks

void WdfDmaEnablerSetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler,
  [in] size_t        MaximumFragments
);

Parameter

[in] DmaEnabler

Handel ke objek pengaktif DMA yang diperoleh driver dari panggilan sebelumnya ke WdfDmaEnablerCreate.

[in] MaximumFragments

Jumlah maksimum elemen sebar/kumpulkan yang dapat didukung driver dan perangkat.

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Jika driver Anda memanggil WdfDmaEnablerSetMaximumScatterGatherElements, driver harus melakukannya dalam fungsi panggilan balik EvtDriverDeviceAdd atau EvtDevicePrepareHardware .

Jika driver Anda tidak memanggil WdfDmaEnablerSetMaximumScatterGatherElements, kerangka kerja menggunakan nilai default WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, yang berarti bahwa tidak ada batasan jumlah elemen sebar/kumpulkan.

Untuk informasi selengkapnya tentang metode ini, lihat Mengaktifkan Transaksi DMA.

Contoh

Contoh kode berikut menetapkan jumlah maksimum elemen sebar/kumpulkan untuk objek pengaktif DMA tertentu.

WdfDmaEnablerSetMaximumScatterGatherElements(
                                             DmaEnabler, 
                                             NIC_MAX_PHYS_BUF_COUNT
                                             );

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfdmaenabler.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WdfDmaEnablerCreate

WdfDmaEnablerGetMaximumScatterGatherElements