fungsi WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT (wdfdmaenabler.h)

Artikel
02/27/2024

[Hanya berlaku untuk KMDF]

Fungsi WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT menginisialisasi struktur WDF_DMA_SYSTEM_PROFILE_CONFIG driver.

Sintaks

void WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT(
       PWDF_DMA_SYSTEM_PROFILE_CONFIG  DmaConfig,
  [in] PHYSICAL_ADDRESS                Address,
  [in] DMA_WIDTH                       DmaWidth,
  [in] PCM_PARTIAL_RESOURCE_DESCRIPTOR DmaDescriptor
);

Parameter

DmaConfig

Penunjuk ke struktur WDF_DMA_SYSTEM_PROFILE_CONFIG yang dialokasikan driver.

[in] Address

Alamat yang diterjemahkan dari register ke target untuk DMA. Untuk informasi selengkapnya, lihat Keterangan.

[in] DmaWidth

Lebar register yang ditentukan oleh Address.

[in] DmaDescriptor

Deskriptor sumber daya yang diterjemahkan untuk saluran DMA yang ditetapkan perangkat selama EvtDevicePrepareHardware.

Nilai kembali

Tidak ada

Keterangan

Biasanya, driver memanggil WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT dari dalam fungsi panggilan balik EvtDevicePrepareHardware . Driver harus memanggil fungsi WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT sebelum memanggil WdfDmaEnablerConfigureSystemProfile.

Tergantung pada desain System on a Chip (SoC), parameter Address mungkin memiliki arti yang berbeda. Misalnya jika DMA menggunakan port transfer khusus pada perangkat, Alamat mungkin menunjukkan port tempat penulisan DMA terjadi.

Untuk informasi selengkapnya tentang membuat pengaktif DMA mode sistem, lihat Mendukung System-Mode DMA.

Contoh

Untuk contoh kode yang menggunakan WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT, lihat WdfDmaEnablerConfigureSystemProfile.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Target Platform	Universal
Versi KMDF minimum	1.11
Header	wdfdmaenabler.h (termasuk Wdf.h)

Lihat juga

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate

Bagikan melalui