# CARD_ReadFlash

## C Specification

  `#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 | Byte length of data being read

## 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 detailed result value when the process fails, call the `CARD_GetResultCode` function. In order 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_WriteFlash`, `CARD_VerifyFlash`, `CARD_WriteAndVerifyFlash`

## Revision History

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

CONFIDENTIAL