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
DMA 通道的已转换资源描述符在 EvtDevicePrepareHardware 期间分配了设备。
返回值
无
备注
通常，驱动程序从其 EvtDevicePrepareHardware 回调函数中调用 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT。 驱动程序必须在调用 WdfDmaEnablerConfigureSystemProfile 之前调用 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT 函数。
根据芯片上的系统 (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) |