Fungsi WdfDmaTransactionGetBytesTransferred (wdfdmatransaction.h)

[Berlaku untuk KMDF saja]

Metode WdfDmaTransactionGetBytesTransferred mengembalikan jumlah total byte yang telah ditransfer untuk transaksi DMA tertentu.

Sintaks

size_t WdfDmaTransactionGetBytesTransferred(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parameter

[in] DmaTransaction

Handel ke objek transaksi DMA yang diperoleh driver dari panggilan sebelumnya ke WdfDmaTransactionCreate.

Nilai kembali

WdfDmaTransactionGetBytesTransferred mengembalikan jumlah total byte yang telah ditransfer untuk transaksi DMA yang ditentukan parameter DmaTransaction .

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Driver berbasis kerangka kerja biasanya memanggil WdfDmaTransactionGetBytesTransferred dari dalam fungsi panggilan balik peristiwa EvtInterruptDpc , setelah semua transfer DMA selesai, untuk mendapatkan jumlah byte akhir yang ditransfer. Driver biasanya menggunakan jumlah byte akhir sebagai input ke metode WdfRequestCompleteWithInformation . Untuk informasi selengkapnya tentang metode ini, lihat Menyelesaikan Transaksi DMA.

Contoh

Untuk contoh kode yang menggunakan WdfDmaTransactionGetBytesTransferred, lihat WdfDmaTransactionDmaCompleted.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfdmatransaction.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation