DMAIssueRawTransfer (Windows Embedded CE 6.0)

1/6/2010

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

See Also

Reference

CEDDK Dynamic-Link Library DMA Functions
CEDDK Dynamic-Link Library DMA Structures