[仅适用于 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
地址指定的寄存器的宽度。
[in] DmaDescriptor
在 EvtDevicePrepareHardware期间为设备分配的 DMA 通道翻译的资源描述符。
返回值
没有
注解
通常，驱动程序从其 EvtDevicePrepareHardware 回调函数中调用 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT。 驱动程序必须先调用 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT 函数，然后才能调用 WdfDmaEnablerConfigureSystemProfile。
根据芯片上的系统（SoC）设计，Address 参数可能有不同的含义。 例如，如果 DMA 在设备上使用专用传输端口，地址 可能会指示 DMA 写入到的端口。
有关创建系统模式 DMA 启用程序的详细信息，请参阅 支持 System-Mode DMA。
例子
有关使用 WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT的代码示例，请参阅 WdfDmaEnablerConfigureSystemProfile。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 8 |
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.11 |
| 标头 | wdfdmaenabler.h （包括 Wdf.h） |