WdfDmaTransactionInitializeUsingOffset 関数 (wdfdmatransaction.h)
[KMDF にのみ適用]
WdfDmaTransactionInitializeUsingOffset メソッドは、MDL チェーンへのバイト オフセットを使用して、指定された DMA トランザクションを初期化します。
構文
NTSTATUS WdfDmaTransactionInitializeUsingOffset(
[in] WDFDMATRANSACTION DmaTransaction,
[in] PFN_WDF_PROGRAM_DMA EvtProgramDmaFunction,
[in] WDF_DMA_DIRECTION DmaDirection,
[in] PMDL Mdl,
[in] size_t Offset,
[in] size_t Length
);
パラメーター
[in] DmaTransaction
ドライバーが WdfDmaTransactionCreate の以前の呼び出しから取得した DMA トランザクション オブジェクトへのハンドル。
[in] EvtProgramDmaFunction
ドライバーの EvtProgramDma イベント コールバック関数へのポインター。
[in] DmaDirection
WDF_DMA_DIRECTION型指定された値。
[in] Mdl
DMA トランザクションに使用されるバッファーを記述するメモリ記述子リスト (MDL) へのポインター。 詳細については、「解説」を参照 してください。
[in] Offset
現在のトランザクションの MDL チェーンへのバイト オフセット。
[in] Length
転送するバイト数。 これは、0 より大きい値である必要があります。
戻り値
WdfDmaTransactionInitializeUsingOffset は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、メソッドは WdfDmaTransactionInitialize の戻り値セクションで説明されている値のいずれかを返す可能性があります。
このメソッドは、他の NTSTATUS 値を返す場合もあります。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
WdfDmaTransactionInitializeUsingOffset は WdfDmaTransactionInitialize と同じですが、仮想アドレスではなく MDL チェーンによって記述されたバッファーにオフセットが取り込まれます。
ドライバーは、このメソッドの Mdl パラメーターで MDL チェーンを指定できます。 MDL チェーンは、ドライバーが MDL 構造体の Next メンバーを使用して連結された MDL 構造体のシーケンスです。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.11 |
| Header | wdfdmatransaction.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf) |