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);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfdmaenabler.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |