# GXS_LoadOAM

## C Specification

      #include <nitro/gx/gx_load.h>

      void GXS_LoadOAM(const void *pSrc, u32 offset, u32 szByte);

## Description

This function uses DMA to transfer OAM data to the sub 2D Engine OAM. An offset can be specified for the transfer destination address. The DMA channel that is used is `GX_DMAID` (defined in `gxcommon.h`). The transfer destination address is `HW_DB_OAM` in the ARM9 memory space + `offset`. Both `offset` and `szByte` must be 4-byte aligned.

Notes:

- Because the DMA transfer is carried out internally, the transfer source data must be flushed to the main memory using a function such as `DC_FlushRange` prior to the process.
- If the regions for transfer source and transfer destination overlap, the operation result is not guaranteed.

## Arguments

`pSrc` | Pointer to transfer source
`offset` | Offset
`szByte` | Transfer size (in bytes)

## Return Values

None

## See Also

`GXS_LoadOBJ`, `GXS_LoadOBJPltt`

## Revision History

02/09/2004 Initial Version