Fungsi WdfDmaTransactionInitializeUsingOffset (wdfdmatransaction.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfDmaTransactionInitializeUsingOffset menginisialisasi transaksi DMA tertentu dengan menggunakan offset byte ke dalam rantai MDL.

Sintaks

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
);

Parameter

[in] DmaTransaction

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

[in] EvtProgramDmaFunction

Penunjuk ke fungsi panggilan balik peristiwa EvtProgramDma driver.

[in] DmaDirection

Nilai yang WDF_DMA_DIRECTION ketik.

[in] Mdl

Penunjuk ke daftar deskriptor memori (MDL) yang menjelaskan buffer yang akan digunakan untuk transaksi DMA. Lihat informasi selengkapnya di Keterangan.

[in] Offset

Offset byte ke dalam rantai MDL untuk transaksi saat ini.

[in] Length

Jumlah byte yang akan ditransfer. Nilai ini harus lebih besar dari nol.

Nilai kembali

WdfDmaTransactionInitializeUsingOffset mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode mungkin mengembalikan salah satu nilai yang dijelaskan di bagian Nilai pengembalian dari WdfDmaTransactionInitialize.

Metode ini juga mungkin mengembalikan nilai NTSTATUS lainnya.

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

Keterangan

WdfDmaTransactionInitializeUsingOffset setara dengan WdfDmaTransactionInitialize kecuali bahwa ia mengambil offset ke dalam buffer yang dijelaskan oleh rantai MDL daripada alamat virtual.

Driver dapat menentukan rantai MDL dalam parameter Mdl dari metode ini. Rantai MDL adalah urutan struktur MDL yang dirangkai driver bersama-sama menggunakan anggota berikutnya dari struktur MDL.

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

WdfDmaTransactionInitialize