Fungsi WdfDmaTransactionGetDevice (wdfdmatransaction.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfDmaTransactionGetDevice mengembalikan handel ke objek perangkat kerangka kerja yang terkait dengan transaksi DMA tertentu.

Sintaks

WDFDEVICE WdfDmaTransactionGetDevice(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parameter

[in] DmaTransaction

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

Nilai kembali

WdfDmaTransactionGetDevice mengembalikan handel ke objek perangkat kerangka kerja yang ditentukan driver ketika disebut WdfDmaTransactionCreate.

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

Keterangan

Untuk informasi selengkapnya tentang menyelesaikan transfer DMA, lihat Menyelesaikan Transfer DMA.

Contoh

Contoh kode berikut mendapatkan handel ke objek perangkat kerangka kerja yang terkait dengan transaksi DMA tertentu.

WDFDEVICE device;

device = WdfDmaTransactionGetDevice(DmaTransaction);

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

WdfDmaTransactionCreate