# CARD_WriteFlash

## 構文

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

## 引数

dst | 転送先の FLASH アドレス
src | 転送元のメモリアドレス
len | 書き込むデータのバイト長

## 返り値

処理が正しく成功すれば TRUE を、そうでないなら FALSE を返します。

## 説明

FLASH デバイスへデータを書き込みます。
この関数は処理が完了するまで制御を返しません。
処理が正しく成功すれば TRUE を、失敗した場合は FALSE を返します。
失敗時の詳細な結果値を取得するにはCARD_GetResultCode( )を呼び出してください。

## 注意

- この関数を使用する場合、事前にアクセスバスをCARD_LockBackup( )でロックしている必要があります。
- この関数は内部でPXIを介してARM7プロセッサと通信しています。PXIの割り込みが有効でないと処理が完了しない点に注意してください。
- 一部の大容量FLASHデバイスは"Write"操作に対応できないため、この関数を呼び出してもCARD_RESULT_UNSUPPORTEDを返して失敗します。「バックアップアクセス概要」に記載された詳細をご参照の上、必要に応じてCARD_WriteFlashSector( )などで代替してください。

## 参照

`CARD_GetResultCode, CARD_IsBackupFlash, CARD_WriteFlashAsync, CARD_ReadFlash, CARD_VerifyFlash, CARD_WriteAndVerifyFlash`

## 履歴

2007/11/13 一部の大容量FLASHがこの関数を使用できない旨の記述追加
2004/12/09 記述修正 「IOプロセッサ」→「ARM7プロセッサ」
2004/08/31 CARD_GetResultCode( )についての記述を追加
2004/08/23 初版