WdfDmaEnablerGetMaximumScatterGatherElements 函式 (wdfdmaenabler.h)

[僅適用於 KMDF]

WdfDmaEnablerGetMaximumScatterGatherElements 方法會針對指定的 DMA 啟用器物件傳回裝置和驅動程式支援的散佈/收集元素數目上限。

語法

size_t WdfDmaEnablerGetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler
);

[in] DmaEnabler

驅動程式從先前呼叫 WdfDmaEnablerCreate 取得的 DMA 啟用器物件的句柄。

如果驅動程式先前稱為 WdfDmaEnablerSetMaximumScatterGatherElements，WdfDmaEnablerGetMaximumScatterGatherElements 會傳回上一個呼叫中指定的驅動程式值。否則， WdfDmaEnablerGetMaximumScatterGatherElements 會傳回WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS，這表示散佈/收集元素數目沒有限制。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

如需此方法的詳細資訊，請參閱啟用 DMA 交易。

下列程式代碼範例會取得指定之 DMA 啟用子物件的散佈/收集元素數目上限。

size_t maxElements;

maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);

需求	值
目標平台	Universal
最小 KMDF 版本	1.0
標頭	wdfdmaenabler.h (包含 Wdf.h)
程式庫	Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL	<=DISPATCH_LEVEL
DDI 合規性規則	DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)