# CARD_ReadFlash

## C Specification

      #include <nitro/card.h>

      BOOL CARD_ReadFlash(u32 src, void *dst, u32 len);

## Description

This function synchronously reads out data from the FLASH device. This function will not return the control until the processing has completed.

This function returns a value of TRUE if the process succeeds, and returns a value of FALSE if the process fails. To obtain the detailed result value when the process fails, call the `CARD_GetResultCode` function.

When using this function, the access bus must be locked in advance using the `CARD_LockBackup` function.

This function performs communications internally with the I/O processor through PXI. Be aware that the process will not complete unless the PXI interrupt is enabled.

## Arguments

`src` | The FLASH address of the transmission source
`dst` | The memory address of the transmission destination
`len` | The byte length of the data to be read out

## Return Values

Returns a value of TRUE if the processing is correct and successful. Returns a value of FALSE otherwise.

## See Also

`CARD_GetResultCode`, `CARD_IsBackupFlash`, `CARD_ReadFlashAsync`, `CARD_WriteFlash`, `CARD_VerifyFlash`, `CARD_WriteAndVerifyFlash`

## Revision History

08/31/2004 Added the description for the `CARD_GetResultCode` function.
08/23/2004 Revised the links due to changes to the function
08/18/2004 Initial Version