cart_load.h File Reference

ROM/save loading functions. More...

Go to the source code of this file.

Enumerations
enum	cart_load_err_t {   CART_LOAD_OK , CART_LOAD_ERR_ROM_LOAD_FAIL , CART_LOAD_ERR_SAVE_LOAD_FAIL , CART_LOAD_ERR_BOOT_MODE_FAIL ,   CART_LOAD_ERR_64DD_PRESENT , CART_LOAD_ERR_64DD_IPL_NOT_FOUND , CART_LOAD_ERR_64DD_IPL_LOAD_FAIL , CART_LOAD_ERR_64DD_DISK_LOAD_FAIL ,   CART_LOAD_ERR_EMU_NOT_FOUND , CART_LOAD_ERR_EMU_LOAD_FAIL , CART_LOAD_ERR_EMU_ROM_LOAD_FAIL , CART_LOAD_ERR_CREATE_SAVES_SUBDIR_FAIL ,   CART_LOAD_ERR_EXP_PAK_NOT_FOUND , CART_LOAD_ERR_FUNCTION_NOT_SUPPORTED }
	Cart load state enumeration. More...
enum	cart_load_emu_type_t {   CART_LOAD_EMU_TYPE_NES , CART_LOAD_EMU_TYPE_SNES , CART_LOAD_EMU_TYPE_GAMEBOY , CART_LOAD_EMU_TYPE_GAMEBOY_COLOR ,   CART_LOAD_EMU_TYPE_SEGA_GENERIC_8BIT , CART_LOAD_EMU_TYPE_FAIRCHILD_CHANNELF }
	Cart load type enumeration. More...

Functions
char *	cart_load_convert_error_message (cart_load_err_t err)
	Convert a cart load error code to a human-readable error message.
cart_load_err_t	cart_load_n64_rom_and_save (menu_t *menu, flashcart_progress_callback_t progress)
	Load an N64 ROM and its save data.
cart_load_err_t	cart_load_64dd_ipl_and_disk (menu_t *menu, flashcart_progress_callback_t progress)
	Load the 64DD IPL (BIOS) and disk.
cart_load_err_t	cart_load_emulator (menu_t *menu, cart_load_emu_type_t emu_type, flashcart_progress_callback_t progress)
	Load an emulator and its ROM.

Detailed Description

ROM/save loading functions.

Enumeration Type Documentation

cart_load_err_t

enum cart_load_err_t

Cart load state enumeration.

Enumerator
CART_LOAD_OK	Returned no error.
CART_LOAD_ERR_ROM_LOAD_FAIL	Failed to load the ROM correctly.
CART_LOAD_ERR_SAVE_LOAD_FAIL	Failed to load the save correctly.
CART_LOAD_ERR_BOOT_MODE_FAIL	Failed to set the next boot mode.
CART_LOAD_ERR_64DD_PRESENT	The 64DD is available for use.
CART_LOAD_ERR_64DD_IPL_NOT_FOUND	Failed to find the 64DD IPL (BIOS) file.
CART_LOAD_ERR_64DD_IPL_LOAD_FAIL	Failed to load the 64DD IPL (BIOS) file.
CART_LOAD_ERR_64DD_DISK_LOAD_FAIL	Failed to find the 64DD disk.
CART_LOAD_ERR_EMU_NOT_FOUND	Failed to find the emulator required.
CART_LOAD_ERR_EMU_LOAD_FAIL	Failed to load the emulator required.
CART_LOAD_ERR_EMU_ROM_LOAD_FAIL	Failed to load the emulator ROM.
CART_LOAD_ERR_CREATE_SAVES_SUBDIR_FAIL	Failed to create the save sub-directory.
CART_LOAD_ERR_EXP_PAK_NOT_FOUND	There was not enough system memory available (expected an Expansion PAK).
CART_LOAD_ERR_FUNCTION_NOT_SUPPORTED	An unexpected response.

cart_load_emu_type_t

enum cart_load_emu_type_t

Cart load type enumeration.

Enumerator
CART_LOAD_EMU_TYPE_NES	The ROM is designed for a Nintendo Entertainment System or Famicom.
CART_LOAD_EMU_TYPE_SNES	The ROM is designed for a Super Nintendo Entertainment System or Super Famicom.
CART_LOAD_EMU_TYPE_GAMEBOY	The ROM is designed for a Nintendo Gameboy.
CART_LOAD_EMU_TYPE_GAMEBOY_COLOR	The ROM is designed for a Nintendo Gameboy Color.
CART_LOAD_EMU_TYPE_SEGA_GENERIC_8BIT	The ROM is designed for a Sega 8Bit system (Game Gear or Master System).
CART_LOAD_EMU_TYPE_FAIRCHILD_CHANNELF	The ROM is designed for a Fairchild Channel F system.

Function Documentation

cart_load_convert_error_message()

char * cart_load_convert_error_message

(

cart_load_err_t

err

)

Convert a cart load error code to a human-readable error message.

Parameters

err	The cart load error code.

Returns

char* The human-readable error message.

Convert a cart load error code to a human-readable error message.

Parameters

err	The cart load error code.

Returns

char* The error message.

cart_load_n64_rom_and_save()

cart_load_err_t cart_load_n64_rom_and_save	(	menu_t *	menu,
		flashcart_progress_callback_t	progress )

Load an N64 ROM and its save data.

Parameters

menu	Pointer to the menu structure.
progress	Callback function for progress updates.

Returns

cart_load_err_t Error code.

Load an N64 ROM and its save data.

Parameters

menu	Pointer to the menu structure.
progress	Progress callback function.

Returns

cart_load_err_t Error code.

cart_load_64dd_ipl_and_disk()

cart_load_err_t cart_load_64dd_ipl_and_disk	(	menu_t *	menu,
		flashcart_progress_callback_t	progress )

Load the 64DD IPL (BIOS) and disk.

Parameters

menu	Pointer to the menu structure.
progress	Callback function for progress updates.

Returns

cart_load_err_t Error code.

Load the 64DD IPL (BIOS) and disk.

Parameters

menu	Pointer to the menu structure.
progress	Progress callback function.

Returns

cart_load_err_t Error code.

cart_load_emulator()

cart_load_err_t cart_load_emulator	(	menu_t *	menu,
		cart_load_emu_type_t	emu_type,
		flashcart_progress_callback_t	progress )

Load an emulator and its ROM.

Parameters

menu	Pointer to the menu structure.
emu_type	The type of emulator to load.
progress	Callback function for progress updates.

Returns

cart_load_err_t Error code.

Parameters

menu	Pointer to the menu structure.
emu_type	The type of emulator to load.
progress	Progress callback function.

Returns

cart_load_err_t Error code.