DMAIssueRawTransfer (Compact 2013)

3/26/2014

This function sets up map descriptor registers for a channel to map a DMA transfer from a locked-down buffer. This function fails if there are other DMA transfers queued in the DMA channel.

Syntax

BOOL DMAIssueRawTransfer (
  DMA_TRANSFER_HANDLE *phDmaHandle,
  HANDLE hDmaChannel,
  PVOID lpInPtr,
  DWORD nInLen,
  HANDLE hNotifyHandle,
  PVOID NotifyContext1,
  PVOID NotifyContext2
);

Parameters

  • phDmaHandle
    [in, out] point to a HANDLE that returns DMA_TRANSFER_HANDLE on success
  • hDmaChannel
    [in, out] When DMAIssueRawTransfer returns TRUE, for success, term is a pointer to a DMA_TRANSFER_HANDLE.
  • lpInPtr
    [in] Long pointer to a buffer that contains the data required to perform the operation. This pointer is set to NULL if the dwIoControlCode parameter specifies an operation that does not require input data.
  • nInLen
    [in] Size, in bytes, of the buffer pointed to by lpInBuffer.
  • hNotifyHandle
    [in] Event Handle used when SetEvent is called after the DMA transfer finishes. If this handle is NULL then no call to SetEvent is made when the transfer is finished.
  • NotifyContext1
    [in] Context1 allows a User to attach content to the DMA transfer. The content is retrieved using DMAGetContexts and a valid DMA Handle.
  • NotifyContext2
    [in] Context2 allows a User to attach content to the DMA transfer. The content is retrieved using DMAGetContexts and a valid DMA Handle.

Return Value

Returns TRUE on success. Returns FALSE on failure.

Requirements

Header

oaldma.h

Library

CEDDK.lib

See Also

Reference

Ceddk.dll DMA Functions
Ceddk.dll DMA Structures