N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential





osContReset

Syntax
#include <ultra64.h>     /* os.h */
s32 osContReset(OSMesgQueue *mq, OSContStatus *status);

Explanation
osContReset resets all the direct SI devices that are connected to the controller ports. Specifically, it sets the current positon of 3D stick of a standard controller back to the nuetral position. If it's a voice recognition system, osContReset resets the parameters set by the initialization functions back to the default values. "mq" is the message queue for initialized messages associated with OS_EVENT_SI events. Please see osSetEventMesg() to learn how to make this association. SI device type and status are returned to status. You must supply a memory block large enough for MAXCONTROLLER structures of type osContStatus. Regarding the osContSetCh() function, it is fine to set the number of direct-type SI devices to be used, to a value less than the value set for MAXCONTROLLERS, if the number of direct-type devices used will not be changed in the future. Please see osContInit() for details on OSContStatus structure.

typedef struct {
    u16     type;   /* The type of SI device inserted in the controller port */
    u8      status; /* The status of the joyport */
    u8      errno;  /* Error from the SI device */
}OSContStatus;

Notes
This function is utilized at the time of SI device development, and is not normally required when creating applications.

See Also
osContInit
osContStartQuery
osContStartReadData
osContSetCh



Nintendo® Confidential

Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.


Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated March 1998