Fungsi WdfDmaTransactionSetChannelConfigurationCallback (wdfdmatransaction.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfDmaTransactionSetChannelConfigurationCallback mendaftarkan fungsi panggilan balik peristiwa konfigurasi saluran untuk transaksi DMA mode sistem.

Sintaks

void WdfDmaTransactionSetChannelConfigurationCallback(
  [in]           WDFDMATRANSACTION                             DmaTransaction,
  [in, optional] PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL ConfigureRoutine,
  [in, optional] PVOID                                         ConfigureContext
);

Parameter

[in] DmaTransaction

Handel ke objek transaksi DMA yang diinisialisasi untuk mengatur atau menghapus panggilan balik konfigurasi saluran.

[in, optional] ConfigureRoutine

Penunjuk ke fungsi panggilan balik peristiwa EvtDmaTransactionConfigureDmaChannel driver, atau NULL untuk menghapusnya.

[in, optional] ConfigureContext

Penunjuk ke buffer yang berisi konteks yang akan diberikan ke fungsi panggilan balik peristiwa EvtDmaTransactionConfigureDmaChannel driver, atau NULL.

Nilai kembali

Tidak ada

Keterangan

Metode ini memungkinkan driver untuk menyesuaikan konfigurasi adaptor sebelum memprogram pengontrol DMA sistem.

Biasanya dari dalam fungsi panggilan balik peristiwa antrean I/O, driver melakukan langkah-langkah berikut, dalam urutan ini:

  1. Memanggil WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize, atau WdfDmaTransactionInitializeUsingOffset untuk menginisialisasi objek transaksi.
  2. Memanggil WdfDmaTransactionSetChannelConfigurationCallback pada objek transaksi.
  3. Memanggil WdfDmaTransactionExecute.
Jika driver telah menentukan fungsi panggilan balik peristiwa EvtDmaTransactionConfigureDmaChannel dengan memanggil WdfDmaTransactionSetChannelConfigurationCallback dan driver kemudian memanggil WdfDmaTransactionRelease, panggilan balik dibersihkan.

WdfDmaTransactionSetChannelConfigurationCallback harus digunakan dengan pengaktif DMA yang menentukan profil DMA mode sistem.

Jika driver Anda memanggil metode ini pada sistem operasi yang lebih awal dari Windows 8, pemverifikasi kerangka kerja melaporkan kesalahan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
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

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease