Function

nuContGBPakFread

Syntax:

s32 nuContGBPakFread(NUContPakFile* handle, u16 address, u8*
buffer, u16 size)

Arguments:

handle	GB Pak control structure (shared with Controller Pak structure)
address	The Game Boy Game Pak address
buffer	Data buffer
size	Byte size

Return Value:

Error

Explanation:

Reads data from a high-performance Game Boy Game Pak

Reads "size" bytes of data into the "buffer" from the specified "address" of the Game Boy Game Pak.

This function can read data even when the Game Boy Game Pak's CPU address and the read size are not multiples of 32. It also internally checks the connector and, after the data is read, checks the status. Furthermore, it checks the address, and if access is to a RAM area in MBC1,2,3 it enables access and then reads the data. After access it write-protects the area.

Since power for the Game Boy Game Pak is not turned on as part of the function before reading, please perform reading or writing after turning power ON and checking the Game Boy Game Pak ID. Also, this function does not turn the power off, so if you are not going to perform a read/write operation after this function, please turn the power OFF with the nuContGBPakPower function.

Since this function uses osGbpakCheckConnector() it only supports Game Paks with MBC 1,2,3 or which do not use a memory controller.

Errors: