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)

另请参阅

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate