CARDCreate

C Specification

#include <revolution/card.h>

#define CARD_FILENAME_MAX   32

s32 CARDCreate(s32 chan, const char* fileName, u32 size, CARDFileInfo* fileInfo);

Arguments

`chan`	EXI channel number.
`fileName`	Pointer to the file name to create. Maximum number of bytes in a file name (excluding terminating zero) is given by `CARD_FILENAME_MAX`.
`size`	Size of the file to create. The size must be a multiple of the card sector size returned by `CARDGetSectorSize`.
`fileInfo`	Pointer to file information to use.

Return Values

One of the following codes:

CARD_RESULT_FATAL_ERROR CARD_RESULT_NOCARD CARD_RESULT_BUSY CARD_RESULT_EXIST CARD_RESULT_NOENT CARD_RESULT_INSSPACE CARD_RESULT_NAMETOOLONG CARD_RESULT_IOERROR CARD_RESULT_READY

Description

Creates a file synchronously. The memory card must have been mounted with CARDMount[Async] before creating a file.

This function may put the current thread to sleep. For precautions when calling similar functions, refer to Interrupts and Callback Functions.

Note: This function is provided for debugging purposes. Applications should not use this function.

Revision History

2007/09/25 Added information on the sleep status of threads.
2006/03/01 Initial version.