WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// wdfdmaenabler.h

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

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-wdfdmaenabler-wdf_dma_system_profile_config_init)

WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT function

Description

[Applies to KMDF only]

The WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT function initializes a driver's WDF_DMA_SYSTEM_PROFILE_CONFIG structure.

Parameters

DmaConfig

A pointer to a driver-allocated WDF_DMA_SYSTEM_PROFILE_CONFIG structure.

Address [in]

The translated address of the register to target for DMA. For more information, see Remarks.

DmaWidth [in]

The width of the register specified by Address.

DmaDescriptor [in]

The translated resource descriptor for the DMA channel assigned the device during EvtDevicePrepareHardware.

Remarks

Typically, a driver calls WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT from within its EvtDevicePrepareHardware callback function. A driver must call the WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT function before calling WdfDmaEnablerConfigureSystemProfile.

Depending on the System on a Chip (SoC) design, the Address parameter might have a different meaning. For example if DMA uses dedicated transfer ports on the device, Address might indicate the port to which DMA writes occur.

For more information about creating a system-mode DMA enabler, see Supporting System-Mode DMA.

Examples

For a code example that uses WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT, see WdfDmaEnablerConfigureSystemProfile.

See also

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate