/*
     File:       Notification.h
 
     Contains:   Notification Manager interfaces
 
     Version:    Technology: System 7.5
                 Release:    QuickTime 6.0.2
 
     Copyright:  (c) 1989-2001 by Apple Computer, Inc., all rights reserved
 
     Bugs?:      For bug reports, consult the following page on
                 the World Wide Web:
 
                     http://developer.apple.com/bugreporter/
 
*/
#ifndef __NOTIFICATION__
#define __NOTIFICATION__

#ifndef __MACTYPES__
#include <MacTypes.h>
#endif

#ifndef __OSUTILS__
#include <OSUtils.h>
#endif




#if PRAGMA_ONCE
#pragma once
#endif

#ifdef __cplusplus
extern "C" {
#endif

#if PRAGMA_IMPORT
#pragma import on
#endif

#if PRAGMA_STRUCT_ALIGN
    #pragma options align=mac68k
#elif PRAGMA_STRUCT_PACKPUSH
    #pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
    #pragma pack(2)
#endif

typedef struct NMRec                    NMRec;
typedef NMRec *                         NMRecPtr;
typedef CALLBACK_API( void , NMProcPtr )(NMRecPtr nmReqPtr);
typedef STACK_UPP_TYPE(NMProcPtr)                               NMUPP;

struct NMRec {
    QElemPtr                        qLink;                      /* next queue entry*/
    short                           qType;                      /* queue type -- ORD(nmType) = 8*/
    short                           nmFlags;                    /* reserved*/
    long                            nmPrivate;                  /* reserved*/
    short                           nmReserved;                 /* reserved*/
    short                           nmMark;                     /* item to mark in Apple menu*/
    Handle                          nmIcon;                     /* handle to small icon*/
    Handle                          nmSound;                    /* handle to sound record*/
    StringPtr                       nmStr;                      /* string to appear in alert*/
    NMUPP                           nmResp;                     /* pointer to response routine*/
    long                            nmRefCon;                   /* for application use*/
};

#if OPAQUE_UPP_TYPES
    EXTERN_API(NMUPP)
    NewNMUPP                       (NMProcPtr               userRoutine);

    EXTERN_API(void)
    DisposeNMUPP                   (NMUPP                   userUPP);

    EXTERN_API(void)
    InvokeNMUPP                    (NMRecPtr                nmReqPtr,
                                    NMUPP                   userUPP);

#else
    enum { uppNMProcInfo = 0x000000C0 };                            /* pascal no_return_value Func(4_bytes) */
    #define NewNMUPP(userRoutine)                                   (NMUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppNMProcInfo, GetCurrentArchitecture())
    #define DisposeNMUPP(userUPP)                                   DisposeRoutineDescriptor(userUPP)
    #define InvokeNMUPP(nmReqPtr, userUPP)                          CALL_ONE_PARAMETER_UPP((userUPP), uppNMProcInfo, (nmReqPtr))
#endif
/* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
#define NewNMProc(userRoutine)                                  NewNMUPP(userRoutine)
#define CallNMProc(userRoutine, nmReqPtr)                       InvokeNMUPP(nmReqPtr, userRoutine)
                                                                                            #if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
                                                                                            #pragma parameter __D0 NMInstall(__A0)
                                                                                            #endif
EXTERN_API( OSErr )
NMInstall                       (NMRecPtr               nmReqPtr)                           ONEWORDINLINE(0xA05E);

                                                                                            #if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
                                                                                            #pragma parameter __D0 NMRemove(__A0)
                                                                                            #endif
EXTERN_API( OSErr )
NMRemove                        (NMRecPtr               nmReqPtr)                           ONEWORDINLINE(0xA05F);



#if PRAGMA_STRUCT_ALIGN
    #pragma options align=reset
#elif PRAGMA_STRUCT_PACKPUSH
    #pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
    #pragma pack()
#endif

#ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
#endif

#ifdef __cplusplus
}
#endif

#endif /* __NOTIFICATION__ */