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

   

nuScAddClient

Format
void nuScAddClient(NUScClient *c, OSMesGueue *mq, NUScMsg msgType)

Arguments
  • c is the pointer to the client structure
  • mq is the pointer to the message reception queue
  • msgType is the type of message entered (use OR for both):

    • nu_SC_RETRACE_MSG = retrace
    • nu_SC_PRE-NMI_MSG = PRE-NMI
Returned Value
none

What This Function Does
It registers Scheduler clients. Retrace and PRE-NMI clients are entered in the Scheduler. When an event occurs, the Scheduler sends a message to the message queues of the registered clients. To remove a client use the nuScRemoveClient function.

Example
#define MESG_NUM   1
NUScClient   client;

OSMesgQueue   mesgQ;
OsMesg      mesgBuf[MESG_NUM];

/* initialize message queue */
osCreateMesgQueue(&mesgQ, mesgBuf,MESG_NUM);

/* specify retrace event and register */
/* client in Scheduler */
nuScAddClient(&client, &mesgQ,
   NU_SC_RETRACE_MSG);

/* wait for retrace event */
osRecvMesg(&mesgQ, NULL,
   OS_SC_MESG_BLOCK);

/* remove registered client */
nuScRemoveClient(&client);



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 January 1998