Fungsi WdfDmaEnablerGetMaximumScatterGatherElements (wdfdmaenabler.h)

[Berlaku untuk KMDF saja]

Metode WdfDmaEnablerGetMaximumScatterGatherElements mengembalikan jumlah maksimum elemen sebar/kumpulkan yang didukung perangkat dan driver, untuk objek pengaktif DMA tertentu.

Sintaks

size_t WdfDmaEnablerGetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler
);

Parameter

[in] DmaEnabler

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

Nilai kembali

Jika driver yang sebelumnya disebut WdfDmaEnablerSetMaximumScatterGatherElements, WdfDmaEnablerGetMaximumScatterGatherElements mengembalikan nilai yang ditentukan driver dalam panggilan sebelumnya. Jika tidak, WdfDmaEnablerGetMaximumScatterGatherElements mengembalikan WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, yang menunjukkan bahwa tidak ada batasan jumlah elemen sebar/kumpulkan.

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

Keterangan

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

Contoh

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

size_t maxElements;

maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);
 

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	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WdfDmaEnablerCreate

WdfDmaEnablerSetMaximumScatterGatherElements