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