GX_TrySetBankForARM7

C Specification

#include <nitro/gx/gx_vramcnt.h>

BOOL GX_TrySetBankForARM7(GXVRamARM7 arm7);

Arguments

arm7   Specifies a VRAM bank to allocate to ARM7 memory space.

Return Values

Returns TRUE if the VRAM bank is allocated as normal. Returns FALSE if the VRAM bank to be allocated is locked by another library.

Description

Attempts to allocate a designated VRAM bank to the ARM7 memory space. If the specified VRAM bank is either disabled or allocated to LCDC, this allocates the VRAM bank to ARM7 memory space. The allocation will fail if the designated VRAM bank is exclusion-locked by another library.

GX_VRAM_ARM7_NONE The VRAM bank is not allocated in the ARM7 memory space.
GX_VRAM_ARM7_128_C 128 kilobytes are reserved in the ARM7 memory space. VRAM-C is allocated.
GX_VRAM_ARM7_128_D 128 kilobytes are reserved in the ARM7 memory space. VRAM-D is allocated.
GX_VRAM_ARM7_256_CD 256 kilobytes are reserved in the ARM7 memory space. VRAM-C and -D are allocated.

The following is the type definition for GXVRamARM7 types.

typedef enum
{
GX_VRAM_ARM7_NONE = 0x0000,
GX_VRAM_ARM7_128_C  = GX_VRAM_C, // ARM7: 0x06000000   -->   0x06020000
GX_VRAM_ARM7_128_D  = GX_VRAM_D, // ARM7: 0x06000000   -->   0x06020000
GX VRAM_ARM7_256_CD = GX_VRAM_C | GX_VRAM_D // ARM7: 0x06000000   -->   0x06040000
}
GXVRamARM7;

See Also

GX_SetBankForARM7, GX_GetBankForARM7, GX_ResetBankForARM7, GX_DisableBankForARM7, GX_GetSizeOfARM7

Revision History

02/15/2005 Initial version