Fungsi WdfDmaTransactionGetTransferInfo (wdfdmatransaction.h)

[Hanya berlaku untuk KMDF]

Metode WdfDmaTransactionGetTransferInfo mengembalikan jumlah register peta dan entri daftar sebar/kumpulkan yang diperlukan untuk transaksi DMA yang diinisialisasi.

Sintaks

void WdfDmaTransactionGetTransferInfo(
  [in]            WDFDMATRANSACTION DmaTransaction,
  [out, optional] ULONG             *MapRegisterCount,
  [out, optional] ULONG             *ScatterGatherElementCount
);

Parameter

[in] DmaTransaction

Handel ke objek transaksi DMA yang diinisialisasi.

[out, optional] MapRegisterCount

Lokasi yang disediakan penelepon yang, saat dikembalikan, berisi jumlah register peta yang diperlukan untuk transaksi yang ditentukan. Parameter ini bersifat opsional dan dapat berupa NULL.

[out, optional] ScatterGatherElementCount

Lokasi yang disediakan penelepon yang, saat dikembalikan, berisi jumlah elemen sebar/kumpulkan yang diperlukan untuk transaksi yang ditentukan. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

Tidak ada

Keterangan

Driver mungkin memanggil WdfDmaTransactionGetTransferInfo sebelum memanggil WdfDmaTransactionAllocateResources atau WdfDmaTransactionExecute.

Saat menggunakan DMA versi 3, metode ini mengembalikan jumlah akurat dari jumlah register peta yang diperlukan. Saat menggunakan versi DMA sebelumnya, metode ini mengasumsikan bahwa setiap halaman memerlukan register peta.

Persyaratan

Persyaratan	Nilai
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

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute