WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT函式 (wdfdmaenabler.h)

[僅適用於 KMDF]

WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT函式會初始化驅動程式的WDF_DMA_SYSTEM_PROFILE_CONFIG結構。

語法

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

參數

DmaConfig

驅動程式配置的 WDF_DMA_SYSTEM_PROFILE_CONFIG 結構的指標。

[in] Address

要以 DMA 為目標之緩存器已翻譯的位址。 如需詳細資訊，請參閱＜備註＞。

[in] DmaWidth

Address 所指定的緩存器寬度。

[in] DmaDescriptor

在 EvtDevicePrepareHardware 期間指派裝置之 DMA 通道的翻譯資源描述元。

傳回值

無

備註

一般而言，驅動程式會從其 EvtDevicePrepareHardware 回呼函式內呼叫WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT。 驅動程式必須先呼叫 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT 函式 ， 才能呼叫 WdfDmaEnablerConfigureSystemProfile。

根據晶元上的系統 (SoC) 設計， Address 參數可能有不同的意義。 例如，如果 DMA 在裝置上使用專用傳輸埠， Address 可能會指出發生 DMA 寫入的埠。

如需建立系統模式 DMA 啟用器的詳細資訊，請參閱 支援 DMA System-Mode。

範例

如需使用 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT 的程式代碼範例，請參閱 WdfDmaEnablerConfigureSystemProfile。

規格需求

需求	值
最低支援的用戶端	Windows 8
目標平台	Universal
最小 KMDF 版本	1.11
標頭	wdfdmaenabler.h (包含 Wdf.h)

另請參閱

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate