Fungsi WdfDmaTransactionGetRequest (wdfdmatransaction.h)
[Berlaku untuk KMDF saja]
Metode WdfDmaTransactionGetRequest mengambil handel ke objek permintaan kerangka kerja yang terkait dengan transaksi DMA tertentu.
Sintaks
WDFREQUEST WdfDmaTransactionGetRequest(
[in] WDFDMATRANSACTION DmaTransaction
);
Parameter
[in] DmaTransaction
Handel ke objek transaksi DMA yang diperoleh driver dari panggilan sebelumnya ke WdfDmaTransactionCreate.
Nilai kembali
WdfDmaTransactionGetRequest mengembalikan handel ke objek permintaan kerangka kerja yang terkait dengan transaksi DMA yang ditentukan parameter DmaTransaction .
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Driver dapat memanggil WdfDmaTransactionGetRequest hanya untuk transaksi DMA yang dibuat driver dengan memanggil WdfDmaTransactionInitializeUsingRequest. Jika driver memanggil WdfDmaTransactionGetRequest untuk transaksi DMA yang dibuatnya dengan memanggil WdfDmaTransactionInitialize, WdfDmaTransactionGetRequest mengembalikan NULL.
Untuk informasi selengkapnya tentang menyelesaikan transfer DMA, lihat Menyelesaikan Transfer DMA.
Contoh
Contoh kode berikut mendapatkan handel ke objek permintaan kerangka kerja yang terkait dengan transaksi DMA tertentu.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(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) |