CARDSetStatus

C Specification

#include <revolution/card.h>
  
#define CARD_READ_SIZE      512
s32 CARDSetStatus(s32 chan, s32 fileNo, CARDStat* stat);

Arguments

chan EXI channel number.
fileNo File entry number.
stat Pointer to file status to set.

Return Values

One of the following codes:

CARD_RESULT_FATAL_ERROR
CARD_RESULT_NOCARD
CARD_RESULT_NOFILE
CARD_RESULT_NOPERM
CARD_RESULT_BUSY
CARD_RESULT_IOERROR
CARD_RESULT_READY

Description

Synchronously sets a file status using a file number. This function does not return until settings have been made.

Note: stat->iconAddr must be 0xffffffff (no icon) or less than CARD_READ_SIZE. At least one icon is required in a game file.

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

Note: The 64 bytes of comment data, specified by start->commentAddr, must not straddle an 8-KB boundary of the file (that is, the comment data must be exactly aligned with [one of] the file's 8-KB blocks).

See Also

Card Functions
CARDStat

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.

CONFIDENTIAL