[僅適用於 KMDF]
WdfDmaEnablerGetMaximumScatterGatherElements 方法會針對指定的 DMA 啟用器物件傳回裝置和驅動程式所支援的最大散佈/收集元素數目。
語法
size_t WdfDmaEnablerGetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler
);
參數
[in] DmaEnabler
驅動程式從先前呼叫 wdfDmaEnablerCreate 取得之 DMA enabler 物件的句柄。
返回值
如果先前呼叫的驅動程式 WdfDmaEnablerSetMaximumScatterGatherElements，WdfDmaEnablerGetMaximumScatterGatherElements 會傳回上一個呼叫中指定的驅動程式值。 否則，WdfDmaEnablerGetMaximumScatterGatherElements 會傳回WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS，這表示散佈/收集元素的數目沒有限制。
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
備註
如需此方法的詳細資訊，請參閱 啟用 DMA 交易。
範例
下列程式代碼範例會取得指定之 DMA enabler 物件的散佈/收集元素數目上限。
size_t maxElements;
maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);
需求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標題 | wdfdmaenabler.h （包括 Wdf.h） |
| 程式庫 | Wdf01000.sys （請參閱架構連結庫版本控制。） |
| IRQL | <=DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |