Expand Minimize

WDF_DMA_PROFILE enumeration

[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                 = 1,
  WdfDmaProfileScatterGather          = 2,
  WdfDmaProfilePacket64               = 3,
  WdfDmaProfileScatterGather64        = 4,
  WdfDmaProfileScatterGatherDuplex    = 5,
  WdfDmaProfileScatterGather64Duplex  = 6,
  WdfDmaProfileSystem                 = 7,
  WdfDmaProfileSystemDuplex           = 8
} WDF_DMA_PROFILE;

Constants

WdfDmaProfileInvalid

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

Minimum KMDF version

1.0

Header

Wdfdmaenabler.h (include Wdf.h)

See also

WDF_DMA_ENABLER_CONFIG

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft