# CTRDG_Enable

## Syntax

  `#include <nitro/ctrdg.h>`
  `void CTRDG_Enable(BOOL enable);`

## Arguments

enable | AGB Cartridge access permission setting. Access is enabled when set to `TRUE` and disabled when set to `FALSE`.

## Return Values

None.

## Description

Toggles whether access to the AGB Game Pak is enabled or disabled. The program forcibly halts if an attempt is made to access the AGB Game Pak while access is disabled. The following is a list of the CTRDG library functions which are affected by the access permission setting made using this function.

- `CTRDG_DmaCopy*`
- `CTRDG_CpuCopy*`
- `CTRDG_Read*`
- `CTRDG_Write*`

The default value for the access permission status is `FALSE`.

## Note

If you are going to use this function to enable access, be sure to follow the stipulations in the Programming Guidelines. Confirm that the procedure is correct before calling the function.

## See Also

`CTRDG_Init`
`CTRDG_IsEnabled`
`CTRDG_CheckEnabled`
`CTRDG_GetAgbMakerCod`e
`CTRDG_GetAgbGameCode`

## Revision History

2005/12/01 Initial version.

CONFIDENTIAL