# CARD_ReadFlash

## Syntax

  `#include <nitro/card.h>`
  `BOOL CARD_ReadFlash(u32 src, void *dst, u32 len);`

## Arguments

`src` | The FLASH address of the transfer source
`dst` | Transfer destination memory address.
`len` | Length of data being read, in bytes.

## Return Values

TRUE if the process succeeds. FALSE otherwise.

## Description

This function synchronously reads out data from the FLASH device. The function does not return control until it has finished processing. It returns TRUE if the process was successful or FALSE if it failed. To get the value when processing fails, call the `CARD_GetResultCode` function. To use this function, you must first lock the access bus with the `CARD_LockBackup` function.
This function communicates with the ARM7 processor internally via PXI.
The process will not end if PXI interrupts are not enabled.

## See Also

`CARD_GetResultCode
CARD_IsBackupFlash
CARD_ReadFlashAsync
CARD_VerifyFlash
CARD_WriteAndVerifyFlash
CARD_WriteFlash`

## Revision History

2004/12/09 Changed "IO processor" to "ARM7 processor".
2004/08/31 Added a description of the `CARD_GetResultCode` function.
2004/08/23 Revised links due to function changes.
2004/08/18 Initial version.

CONFIDENTIAL