Fungsi WdfDmaTransactionWdmGetTransferContext (wdfdmatransaction.h)

[Hanya berlaku untuk KMDF]

Metode WdfDmaTransactionWdmGetTransferContext mengambil konteks transfer WDM yang terkait dengan transaksi DMA.

Sintaks

PVOID WdfDmaTransactionWdmGetTransferContext(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parameter

[in] DmaTransaction

Handel ke objek transaksi DMA yang diinisialisasi untuk mengambil konteks transfer.

Nilai kembali

Penunjuk ke konteks transfer DMA (PTRANSFER_CONTEXT) yang terkait dengan transaksi.

Keterangan

Konteks transfer DMA untuk transaksi dialokasikan ketika driver membuat transaksi.

WdfDmaTransactionWdmGetTransferContext harus digunakan dengan pengaktif DMA yang menggunakan DMA versi 3. Untuk memilih versi 3, atur anggota WdmDmaVersionOverridedari WDF_DMA_ENABLER_CONFIG ke 3.

Driver Anda dapat menggunakan konteks transfer DMA untuk memanggil rutinitas pustaka WDM DMA berikut secara langsung:

• AllocateAdapterChannelEx
• CancelAdapterChannel
• CancelMappedTransfer
• GetScatterGatherListEx
• BuildScatterGatherListEx

Anda harus menginisialisasi transaksi DMA sebelum memanggil WdfDmaTransactionWdmGetTransferContext.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Target Platform	Universal
Versi KMDF minimum	1.11
Header	wdfdmatransaction.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf)

Lihat juga

WdfDmaTransactionCreate