#include <nitro/card.h>
void CARD_ReadRom( u32 dma, const void *src, void *dst, u32 len);
This function synchronously reads data from a device that has ROM.
The access bus must be locked before using this function.
This function is equivalent to calling the CARD_ReadRomAsync function with no callback specification and unconditionally waiting for it to complete.
For details on the internal operation of this function, see the description of the CARD_ReadRomAsync function.
If a valid DMA channel is specified by this function, that DMA channel will not be available until transfer is complete.
Note that because this function uses interrupts internally, the process will not complete if it attempts to run while interrupts are prohibited.
dma |
The DMA channel to be used for transfer. If it is out of range, the CPU will transfer. If a valid DMA channel is specified, that DMA channel will not be available for any other task until transfer is complete. |
src |
The transfer source CARD ROM address. |
dst |
The transfer destination memory address. |
len |
The length of the read data (in bytes). |
None.
CARD_LockRom, CARD_ReadRomAsync
11/02/2004 Corrected an argument name.
07/13/2004 Added caution concerning use with DMA.
07/09/2004 Revised description due to change in function format.
07/05/2004 Initial version.