PortAudio 2.0

pa_trace.h

Go to the documentation of this file.
00001 #ifndef PA_TRACE_H
00002 #define PA_TRACE_H
00003 /*
00004  * $Id: pa_trace.h 1339 2008-02-15 07:50:33Z rossb $
00005  * Portable Audio I/O Library Trace Facility
00006  * Store trace information in real-time for later printing.
00007  *
00008  * Based on the Open Source API proposed by Ross Bencina
00009  * Copyright (c) 1999-2000 Phil Burk
00010  *
00011  * Permission is hereby granted, free of charge, to any person obtaining
00012  * a copy of this software and associated documentation files
00013  * (the "Software"), to deal in the Software without restriction,
00014  * including without limitation the rights to use, copy, modify, merge,
00015  * publish, distribute, sublicense, and/or sell copies of the Software,
00016  * and to permit persons to whom the Software is furnished to do so,
00017  * subject to the following conditions:
00018  *
00019  * The above copyright notice and this permission notice shall be
00020  * included in all copies or substantial portions of the Software.
00021  *
00022  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
00023  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
00024  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
00025  * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
00026  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
00027  * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
00028  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
00029  */
00030 
00031 /*
00032  * The text above constitutes the entire PortAudio license; however, 
00033  * the PortAudio community also makes the following non-binding requests:
00034  *
00035  * Any person wishing to distribute modifications to the Software is
00036  * requested to send the modifications to the original developer so that
00037  * they can be incorporated into the canonical version. It is also 
00038  * requested that these non-binding requests be included along with the 
00039  * license above.
00040  */
00041 
00068 #ifndef PA_TRACE_REALTIME_EVENTS
00069 #define PA_TRACE_REALTIME_EVENTS     (0)   
00070 #endif
00071 
00072 #ifndef PA_MAX_TRACE_RECORDS
00073 #define PA_MAX_TRACE_RECORDS      (2048)   
00074 #endif
00075 
00076 #ifdef __cplusplus
00077 extern "C"
00078 {
00079 #endif /* __cplusplus */
00080 
00081 
00082 #if PA_TRACE_REALTIME_EVENTS
00083 
00084 void PaUtil_ResetTraceMessages();
00085 void PaUtil_AddTraceMessage( const char *msg, int data );
00086 void PaUtil_DumpTraceMessages();
00087     
00088 #else
00089 
00090 #define PaUtil_ResetTraceMessages() /* noop */
00091 #define PaUtil_AddTraceMessage(msg,data) /* noop */
00092 #define PaUtil_DumpTraceMessages() /* noop */
00093 
00094 #endif
00095 
00096 
00097 #ifdef __cplusplus
00098 }
00099 #endif /* __cplusplus */
00100 
00101 #endif /* PA_TRACE_H */