home *** CD-ROM | disk | FTP | other *** search
/ Apple Developer Connection 1998 Fall: Game Toolkit / Disc.iso / SDKs / QuickTime Mac / ComponentIncludes / Sound.k.h < prev   
Encoding:
C/C++ Source or Header  |  1998-04-09  |  8.9 KB  |  220 lines  |  [TEXT/MPS ]
  1. /*
  2.      File:        Sound.k.h
  3.  
  4.      Contains:    Sound Manager Interfaces.
  5.  
  6.      Version:    Technology:    Sound Manager 3.3
  7.                  Release:    QuickTime 3.0
  8.  
  9.      Copyright:    © 1986-1998 by Apple Computer, Inc., all rights reserved
  10.  
  11.      Bugs?:        Please include the the file and version information (from above) with
  12.                  the problem description.  Developers belonging to one of the Apple
  13.                  developer programs can submit bug reports to:
  14.  
  15.                      devsupport@apple.com
  16.  
  17. */
  18. #ifndef __SOUND_K__
  19. #define __SOUND_K__
  20.  
  21. #include <Sound.h>
  22.  
  23. #if OLDROUTINENAMES
  24. #endif
  25. #if TARGET_RT_LITTLE_ENDIAN
  26. #else
  27. #endif
  28. #if OLDROUTINENAMES && TARGET_CPU_68K
  29. #endif
  30. #if OLDROUTINENAMES
  31. #endif
  32. /*
  33.     Example usage:
  34.  
  35.         #define SOUNDCOMPONENT_BASENAME()    Fred
  36.         #define SOUNDCOMPONENT_GLOBALS()    FredGlobalsHandle
  37.         #include <Sound.k.h>
  38.  
  39.     To specify that your component implementation does not use globals, do not #define SOUNDCOMPONENT_GLOBALS
  40. */
  41. #ifdef SOUNDCOMPONENT_BASENAME
  42.     #ifndef SOUNDCOMPONENT_GLOBALS
  43.         #define SOUNDCOMPONENT_GLOBALS() 
  44.         #define ADD_SOUNDCOMPONENT_COMMA 
  45.     #else
  46.         #define ADD_SOUNDCOMPONENT_COMMA ,
  47.     #endif
  48.     #define SOUNDCOMPONENT_GLUE(a,b) a##b
  49.     #define SOUNDCOMPONENT_STRCAT(a,b) SOUNDCOMPONENT_GLUE(a,b)
  50.     #define ADD_SOUNDCOMPONENT_BASENAME(name) SOUNDCOMPONENT_STRCAT(SOUNDCOMPONENT_BASENAME(),name)
  51.  
  52.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(InitOutputDevice) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA long  actions);
  53.  
  54.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(SetSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, ComponentInstance  source);
  55.  
  56.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(GetSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, ComponentInstance * source);
  57.  
  58.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(GetSourceData) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundComponentDataPtr * sourceData);
  59.  
  60.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(SetOutput) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundComponentDataPtr  requested, SoundComponentDataPtr * actual);
  61.  
  62.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(AddSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource * sourceID);
  63.  
  64.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(RemoveSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID);
  65.  
  66.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(GetInfo) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, OSType  selector, void * infoPtr);
  67.  
  68.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(SetInfo) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, OSType  selector, void * infoPtr);
  69.  
  70.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(StartSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA short  count, SoundSource * sources);
  71.  
  72.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(StopSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA short  count, SoundSource * sources);
  73.  
  74.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(PauseSource) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA short  count, SoundSource * sources);
  75.  
  76.     EXTERN_API( ComponentResult  ) ADD_SOUNDCOMPONENT_BASENAME(PlaySourceBuffer) (SOUNDCOMPONENT_GLOBALS() ADD_SOUNDCOMPONENT_COMMA SoundSource  sourceID, SoundParamBlockPtr  pb, long  actions);
  77.  
  78.  
  79.     /* MixedMode ProcInfo constants for component calls */
  80.     enum {
  81.         uppSoundComponentInitOutputDeviceProcInfo = 0x000003F0,
  82.         uppSoundComponentSetSourceProcInfo = 0x00000FF0,
  83.         uppSoundComponentGetSourceProcInfo = 0x00000FF0,
  84.         uppSoundComponentGetSourceDataProcInfo = 0x000003F0,
  85.         uppSoundComponentSetOutputProcInfo = 0x00000FF0,
  86.         uppSoundComponentAddSourceProcInfo = 0x000003F0,
  87.         uppSoundComponentRemoveSourceProcInfo = 0x000003F0,
  88.         uppSoundComponentGetInfoProcInfo = 0x00003FF0,
  89.         uppSoundComponentSetInfoProcInfo = 0x00003FF0,
  90.         uppSoundComponentStartSourceProcInfo = 0x00000EF0,
  91.         uppSoundComponentStopSourceProcInfo = 0x00000EF0,
  92.         uppSoundComponentPauseSourceProcInfo = 0x00000EF0,
  93.         uppSoundComponentPlaySourceBufferProcInfo = 0x00003FF0
  94.     };
  95.  
  96. #endif    /* SOUNDCOMPONENT_BASENAME */
  97.  
  98. /*
  99.     Example usage:
  100.  
  101.         #define AUDIO_BASENAME()    Fred
  102.         #define AUDIO_GLOBALS()    FredGlobalsHandle
  103.         #include <Sound.k.h>
  104.  
  105.     To specify that your component implementation does not use globals, do not #define AUDIO_GLOBALS
  106. */
  107. #ifdef AUDIO_BASENAME
  108.     #ifndef AUDIO_GLOBALS
  109.         #define AUDIO_GLOBALS() 
  110.         #define ADD_AUDIO_COMMA 
  111.     #else
  112.         #define ADD_AUDIO_COMMA ,
  113.     #endif
  114.     #define AUDIO_GLUE(a,b) a##b
  115.     #define AUDIO_STRCAT(a,b) AUDIO_GLUE(a,b)
  116.     #define ADD_AUDIO_BASENAME(name) AUDIO_STRCAT(AUDIO_BASENAME(),name)
  117.  
  118.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetVolume) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, ShortFixed * volume);
  119.  
  120.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetVolume) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, ShortFixed  volume);
  121.  
  122.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetMute) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short * mute);
  123.  
  124.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetMute) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short  mute);
  125.  
  126.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetToDefaults) (AUDIO_GLOBALS());
  127.  
  128.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetInfo) (AUDIO_GLOBALS() ADD_AUDIO_COMMA AudioInfoPtr  info);
  129.  
  130.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetBass) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short * bass);
  131.  
  132.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetBass) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short  bass);
  133.  
  134.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetTreble) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short * Treble);
  135.  
  136.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(SetTreble) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  whichChannel, short  Treble);
  137.  
  138.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(GetOutputDevice) (AUDIO_GLOBALS() ADD_AUDIO_COMMA Component * outputDevice);
  139.  
  140.     EXTERN_API( ComponentResult  ) ADD_AUDIO_BASENAME(MuteOnEvent) (AUDIO_GLOBALS() ADD_AUDIO_COMMA short  muteOnEvent);
  141.  
  142.  
  143.     /* MixedMode ProcInfo constants for component calls */
  144.     enum {
  145.         uppAudioGetVolumeProcInfo = 0x00000EF0,
  146.         uppAudioSetVolumeProcInfo = 0x00000AF0,
  147.         uppAudioGetMuteProcInfo = 0x00000EF0,
  148.         uppAudioSetMuteProcInfo = 0x00000AF0,
  149.         uppAudioSetToDefaultsProcInfo = 0x000000F0,
  150.         uppAudioGetInfoProcInfo = 0x000003F0,
  151.         uppAudioGetBassProcInfo = 0x00000EF0,
  152.         uppAudioSetBassProcInfo = 0x00000AF0,
  153.         uppAudioGetTrebleProcInfo = 0x00000EF0,
  154.         uppAudioSetTrebleProcInfo = 0x00000AF0,
  155.         uppAudioGetOutputDeviceProcInfo = 0x000003F0,
  156.         uppAudioMuteOnEventProcInfo = 0x000002F0
  157.     };
  158.  
  159. #endif    /* AUDIO_BASENAME */
  160.  
  161. #if !TARGET_OS_MAC
  162. /*
  163.     Example usage:
  164.  
  165.         #define SNDINPUT_BASENAME()    Fred
  166.         #define SNDINPUT_GLOBALS()    FredGlobalsHandle
  167.         #include <Sound.k.h>
  168.  
  169.     To specify that your component implementation does not use globals, do not #define SNDINPUT_GLOBALS
  170. */
  171. #ifdef SNDINPUT_BASENAME
  172.     #ifndef SNDINPUT_GLOBALS
  173.         #define SNDINPUT_GLOBALS() 
  174.         #define ADD_SNDINPUT_COMMA 
  175.     #else
  176.         #define ADD_SNDINPUT_COMMA ,
  177.     #endif
  178.     #define SNDINPUT_GLUE(a,b) a##b
  179.     #define SNDINPUT_STRCAT(a,b) SNDINPUT_GLUE(a,b)
  180.     #define ADD_SNDINPUT_BASENAME(name) SNDINPUT_STRCAT(SNDINPUT_BASENAME(),name)
  181.  
  182.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(ReadAsync) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA SndInputCmpParamPtr  SICParmPtr);
  183.  
  184.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(ReadSync) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA SndInputCmpParamPtr  SICParmPtr);
  185.  
  186.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(PauseRecording) (SNDINPUT_GLOBALS());
  187.  
  188.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(ResumeRecording) (SNDINPUT_GLOBALS());
  189.  
  190.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(StopRecording) (SNDINPUT_GLOBALS());
  191.  
  192.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(GetStatus) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA short * recordingStatus, unsigned long * totalSamplesToRecord, unsigned long * numberOfSamplesRecorded);
  193.  
  194.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(GetDeviceInfo) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA OSType  infoType, void * infoData);
  195.  
  196.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(SetDeviceInfo) (SNDINPUT_GLOBALS() ADD_SNDINPUT_COMMA OSType  infoType, void * infoData);
  197.  
  198.     EXTERN_API( ComponentResult  ) ADD_SNDINPUT_BASENAME(InitHardware) (SNDINPUT_GLOBALS());
  199.  
  200.  
  201.     /* MixedMode ProcInfo constants for component calls */
  202.     enum {
  203.         uppSndInputReadAsyncProcInfo = 0x000003F0,
  204.         uppSndInputReadSyncProcInfo = 0x000003F0,
  205.         uppSndInputPauseRecordingProcInfo = 0x000000F0,
  206.         uppSndInputResumeRecordingProcInfo = 0x000000F0,
  207.         uppSndInputStopRecordingProcInfo = 0x000000F0,
  208.         uppSndInputGetStatusProcInfo = 0x00003FF0,
  209.         uppSndInputGetDeviceInfoProcInfo = 0x00000FF0,
  210.         uppSndInputSetDeviceInfoProcInfo = 0x00000FF0,
  211.         uppSndInputInitHardwareProcInfo = 0x000000F0
  212.     };
  213.  
  214. #endif    /* SNDINPUT_BASENAME */
  215.  
  216. #endif
  217.  
  218. #endif /* __SOUND_K__ */
  219.  
  220.