HIO2Read

C Specification

#include <revolution/hio2.h>

BOOL    HIO2Read ( HIO2Handle handle, u32 addr, void* buffer, s32 size );

Arguments

`handle`	Handle retrieved using the `HI02Open` function.
`addr`	Read address of shared memory for the EXI-USB interface. This address must be 4-byte aligned.
`buffer`	Pointer to the buffer that stores the data to read. This address must be 32-byte aligned.
`size`	Size of the data to read. Must be a multiple of 32 bytes.

Return Values

Returns TRUE if read succeeds; FALSE otherwise.

Description

The HIO2Read function reads the amount of data size from the start address addr in the specified shared memory and then stores the data in buffer. Data are read in 4-byte increments. This function blocks until all data is read.

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

Revision History

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