# GX_TrySetBankForARM7

## Syntax

  `#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 normally. 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

2005/02/15 Initial version.

CONFIDENTIAL