WdfDmaEnablerSetMaximumScatterGatherElements 関数 (wdfdmaenabler.h)
[KMDF にのみ適用]
WdfDmaEnablerSetMaximumScatterGatherElements メソッドは、指定された DMA イネーブラー オブジェクトに対して、デバイスがサポートする散布図/収集要素の最大数を設定します。
構文
void WdfDmaEnablerSetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler,
[in] size_t MaximumFragments
);
パラメーター
[in] DmaEnabler
WdfDmaEnablerCreateへの以前の呼び出しからドライバーが取得した DMA イネーブラー オブジェクトへのハンドル。
[in] MaximumFragments
ドライバーとデバイスがサポートできる散布図/収集要素の最大数。
戻り値
なし
注釈
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
ドライバーが WdfDmaEnablerSetMaximumScatterGatherElements 呼び出す場合は、EvtDriverDeviceAdd または EvtDevicePrepareHardware コールバック関数 内で呼び出す必要があります。
ドライバーが WdfDmaEnablerSetMaximumScatterGatherElements 呼び出さない場合、フレームワークは既定値の WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS を使用します。これは、散布図/収集要素の数に制限がないことを意味します。
この方法の詳細については、「DMA トランザクションを有効にする」を参照してください。
例示
次のコード例では、指定した DMA イネーブラー オブジェクトの分散/収集要素の最大数を設定します。
WdfDmaEnablerSetMaximumScatterGatherElements(
DmaEnabler,
NIC_MAX_PHYS_BUF_COUNT
);
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 普遍 |
| 最小 KMDF バージョン | 1.0 |
| ヘッダー | wdfdmaenabler.h (Wdf.h を含む) |
| 図書館 | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |