nngxAddVramDmaCommand Function

Syntax

NNGX_APICALL void NNGX_APIENTRY nngxAddVramDmaCommand(
     const GLvoid * srcaddr,
     GLvoid * dstaddr,
     GLsizei size
);

Arguments

Name Description
in srcaddr Transfer source address (main memory).
in dstaddr Transfer destination address (VRAM).
in size Transfer data size.

Return Values

There is no return value.

Description

Issues a DMA transfer command to the current command list.

DMA transfer commands accumulate in the current command list. Used when transferring data from main memory to VRAM without using the GL functions. This operation transfers size bytes of data from the address specified in srcaddr to the address specified in dstaddr.

When using this function to perform a DMA transfer, cache coherecy is handled internally prior to the transfer and does not require support from the calling side.

The following errors occur with this function.

GL_ERROR_8062_DMPA valid command list is not currently bound.
GL_ERROR_8064_DMPThe size argument is negative.

Revision History

2011/02/18
Deleted indications specific to the 8-byte alignment restrictions for srcaddr and dstaddr.
2011/01/17
Added description relating to cache consistency.
2010/06/09
Initial version.

CONFIDENTIAL