WdfDmaTransactionGetTransferInfo 関数 (wdfdmatransaction.h)
[KMDF にのみ適用]
WdfDmaTransactionGetTransferInfo メソッドは、初期化された DMA トランザクションに必要なマップ レジスタと散布図/収集リスト エントリの数を返します。
構文
void WdfDmaTransactionGetTransferInfo(
[in] WDFDMATRANSACTION DmaTransaction,
[out, optional] ULONG *MapRegisterCount,
[out, optional] ULONG *ScatterGatherElementCount
);
パラメーター
[in] DmaTransaction
初期化された DMA トランザクション オブジェクトへのハンドル。
[out, optional] MapRegisterCount
呼び出し元が指定した場所で、指定されたトランザクションに必要なマップ レジスタの数が返されたときに格納されます。 このパラメーターは省略可能であり、NULL にすることができます。
[out, optional] ScatterGatherElementCount
呼び出し元が指定した場所で、指定されたトランザクションに必要な散布図/収集要素の数が返されます。 このパラメーターは省略可能であり、NULL にすることができます。
戻り値
なし
注釈
ドライバーは、WdfDmaTransactionAllocateResources または WdfDmaTransactionExecute 呼び出す前に、WdfDmaTransactionGetTransferInfo を呼び出す場合があります。
DMA バージョン 3 を使用する場合、このメソッドは必要なマップ レジスタの数の正確な数を返します。 以前の DMA バージョンを使用する場合、このメソッドは各ページにマップ レジスタが必要であることを前提としています。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 普遍 |
| 最小 KMDF バージョン | 1.11 |
| ヘッダー | wdfdmatransaction.h (Wdf.h を含む) |
| 図書館 | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf) |