[僅適用於 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 啟用器的詳細資訊，請參閱 支援 System-Mode DMA。
範例
如需使用 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT的程式代碼範例，請參閱 WdfDmaEnablerConfigureSystemProfile。
需求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.11 |
| 標題 | wdfdmaenabler.h （包括 Wdf.h） |