OS_SetPrintOutput

Syntax

#include <nitro/os.h>

void OS_SetPrintOutput( OSPrintOutputProc proc, int num );


(#define directives are given below.)
void OS_SetPrintOutput_Arm9( int num );
void OS_SetPrintOutput_Arm7( int num );
void OS_SetPrintOutput_Arm9Err( int num );
void OS_SetPrintOutput_Arm7Err( int num );

Arguments

proc Specified processor.
num Output window.

Return Values

None.

Description

If the destination for debug output has not been set with a function like OS_Printf, this function specifies the default output destination to use.
The setting made by this function will also apply if the output destination has been set as OS_PRINT_OUTPUT_CURRENT.

We use the term "standard output" to refer to the destination for normal output, like that from OS_Printf. Likewise, we use the term "error output" to refer to the destination for highly urgent output, like that from OS_Panic().

The proc argument is a OSPrintOutputProc-type enumerated type, and specifies one of the following values.

Value of proc Description
OS_PRINT_OUTPUT_PROC_ARM9 Standard output for the ARM9 processor.
OS_PRINT_OUTPUT_PROC_ARM7 Standard output for the ARM7 processor.
OS_PRINT_OUTPUT_PROC_ARM9ERR Error output for the ARM9 processor.
OS_PRINT_OUTPUT_PROC_ARM7ERR Error output for the ARM7 processor.


ARM7 settings can also be changed from the ARM9 side. The reverse is also possible.

num can be set to either 0-3 or OS_PRINT_OUTPUT_NONE.

Value of num Description
0 Output to output window 0.
1 Output to output window 1.
2 Output to output window 2.
3 Output to output window 3.
OS_PRINT_OUTPUT_NONE Do not output.


OS_SetPrintOutput_Arm9( num ) is the #define directive for OS_SetPrintOutput( OS_PRINT_OUTPUT_PROC_ARM9, num ).
OS_SetPrintOutput_Arm7( num ) is the #define directive for OS_SetPrintOutput( OS_PRINT_OUTPUT_PROC_ARM7, num ).
OS_SetPrintOutput_Arm9Err( num ) is the #define directive for OS_SetPrintOutput( OS_PRINT_OUTPUT_PROC_ARM9ERR, num ).
OS_SetPrintOutput_Arm7Err( num ) is the #define directive for OS_SetPrintOutput( OS_PRINT_OUTPUT_PROC_ARM7ERR, num ).

See Also

OS_Printf

Revision History

2008/10/01 Corrected an argument typo.
2008/01/12 Initial version.


CONFIDENTIAL