Edit

Share via

WDF_DMA_PROFILE enumeration (wdfdmaenabler.h)

  • Article

[Applies to KMDF only]

The WDF_DMA_PROFILE enumeration identifies the types of bus-master or system-mode DMA operations that devices can support.

Syntax

typedef enum _WDF_DMA_PROFILE {
  WdfDmaProfileInvalid = 0,
  WdfDmaProfilePacket,
  WdfDmaProfileScatterGather,
  WdfDmaProfilePacket64,
  WdfDmaProfileScatterGather64,
  WdfDmaProfileScatterGatherDuplex,
  WdfDmaProfileScatterGather64Duplex,
  WdfDmaProfileSystem,
  WdfDmaProfileSystemDuplex
} WDF_DMA_PROFILE;

Constants

 
WdfDmaProfileInvalid
Value: 0
For internal use only.
WdfDmaProfilePacket
The device supports single-packet DMA operations, using 32-bit addressing.
WdfDmaProfileScatterGather
The device supports packet-based, scatter/gather DMA operations, using 32-bit addressing.
WdfDmaProfilePacket64
The device supports single-packet DMA operations, using 64-bit addressing.
WdfDmaProfileScatterGather64
The device supports packet-based, scatter/gather DMA operations, using 64-bit addressing.
WdfDmaProfileScatterGatherDuplex
The device supports packet-based, scatter/gather DMA operations, using 32-bit addressing. The device also supports duplex operation.
WdfDmaProfileScatterGather64Duplex
The device supports packet-based, scatter/gather DMA operations, using 64-bit addressing. The device also supports duplex operation.
WdfDmaProfileSystem
The device supports system-mode DMA operations. This value is available in version 1.11 and later versions of KMDF running on Windows 8 or later versions of Windows.
WdfDmaProfileSystemDuplex
The device supports system-mode DMA operations. The device also supports duplex operation. This value is available in version 1.11 and later versions of KMDF running on Windows 8 or later versions of Windows.

Remarks

WDF_DMA_PROFILE-typed values are used within the driver's WDF_DMA_ENABLER_CONFIG structure. The driver supplies WDF_DMA_ENABLER_CONFIG when it calls WdfDmaEnablerCreate.

If the driver selects one of the system-mode DMA profiles, the framework requests the DMA version 3 interface from WDM. System-mode DMA is available starting in Windows 8. For more information about system-mode DMA, see Supporting System-Mode DMA.

Kernel-Mode Driver Framework (KMDF) miniport drivers such as NDIS miniport drivers can request the system-mode DMA profiles. For information about how to write a framework-based miniport driver, see Creating Framework-based Miniport Drivers.

Requirements

Requirement Value
Minimum KMDF version 1.0
Header wdfdmaenabler.h (include Wdf.h)

See also

WDF_DMA_ENABLER_CONFIG