CTRDG_IsEnabled

# CTRDG_Enable

## C Specification

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

## Arguments

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

## Return Values

None.

## Description

This function toggles whether access to the AGB cartridge is enabled or disabled. The program will forcibly halt if an attempt is made to access the AGB cartridge 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 to the AGB Cartridge, 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_GetAgbMakerCode CTRDG_GetAgbGameCode

## Revision History

12/01/2005 Initial version.

CONFIDENTIAL