Share via

CE_DMA_ADAPTER (Windows Embedded CE 6.0)

  • Article

1/6/2010

This structure contains information about a direct memory access (DMA) adapter. The CEDDK Dynamic-Link Library DMA Functions use this information.

Syntax

typedef struct _CE_DMA_ADAPTER {
  ULONG Size;
  INTERFACE_TYPE InterfaceType;
  ULONG BusNumber;
  ULONG DeviceLocation;
  ULONG DmaAdapter;
  ULONG MaximunSizeOfMappingRegister;
  ULONG AddressBoundary;
  ULONG AddressAlignment;
  PHYSICAL_ADDRESS DmaSystemMemoryRangeStart;
  ULONG DmaSystemMemoryRangeLength;
  CE_REGISTER_ACCESS_WIDTH CeDmaWidth;
  CE_DMA_SPEED DmaSpeed;
    BOOLEAN DemandMode;
  BOOLEAN BusMaster;
  DWORD dwFlags;
} DEVICE_DMA_REQUIRMENT_INFO , *PDEVICE_DMA_REQUIRMENT_INFO;

Members

  • Size
    Size of this structure in bytes.
  • InterfaceType
    Interface type on the device. This value could be internal or PCI. The specific value can be found by examining the registry.
  • BusNumber
    Indicates the location of the hardware. The specific value can be found by examining the registry.
  • DeviceLocation
    Device location identifier. This parameter is specific to the type of bus. For a PCI bus, this parameter is a PCI_SLOT_NUMBER value, which is the slot and function numbers combined.
  • DmaAdapter
    Value updated from DEVICE_DMA REQIREMENT_INFO structure. GetDmaAdapter updates this value in order to reflect the adapter that is actually used.
  • MaximumSizeOfMappingRegister
    Maximum number of bytes the DMA mapping register can map.
  • AddressBoundary
    Specifies the address boundary of the DMA physical address register, if there is a boundary the register can not cross.
  • AddressAlignment
    Physical address alignment requirement.
  • DmaSystemMemoryRangeStart
    Absolute lower bound of the DMA address range.
  • DmaSystemMemoryRangeLength
    DMA address range size.
  • CeDmaWidth
    Indicates whether an 8-bit, 16-bit, 32-bit or 64-bit operation should be performed during DMA transfer.
  • DmaSpeed
    DmaSpeed is used by DMAGetAdapter to determine the DMA Adapter and Channel to use. The fastest device should use the highest priority DMA Adaptor and Channel.
  • DemandMode
    Set to TRUE if the device and the DMA hardware have hardware handshaking.
  • BusMaster
    Indicates whether the device is a bus master.
  • dwFlags
    Global DMA transfer flag. This flag is used to determine what kind of transfer the device wants. One valid flag is DMA_FLAGS_INC_DEVICE_ADDRESS, which indicates that the device wants to perform memory to memory DMA transfer.

Requirements

Header oaldma.h
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

CEDDK Dynamic-Link Library DMA Structures