00001 #ifndef PA_WIN_DS_H 00002 #define PA_WIN_DS_H 00003 /* 00004 * $Id: $ 00005 * PortAudio Portable Real-Time Audio Library 00006 * DirectSound specific extensions 00007 * 00008 * Copyright (c) 1999-2007 Ross Bencina and Phil Burk 00009 * 00010 * Permission is hereby granted, free of charge, to any person obtaining 00011 * a copy of this software and associated documentation files 00012 * (the "Software"), to deal in the Software without restriction, 00013 * including without limitation the rights to use, copy, modify, merge, 00014 * publish, distribute, sublicense, and/or sell copies of the Software, 00015 * and to permit persons to whom the Software is furnished to do so, 00016 * subject to the following conditions: 00017 * 00018 * The above copyright notice and this permission notice shall be 00019 * included in all copies or substantial portions of the Software. 00020 * 00021 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 00022 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 00023 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 00024 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR 00025 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF 00026 * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 00027 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 00028 */ 00029 00030 /* 00031 * The text above constitutes the entire PortAudio license; however, 00032 * the PortAudio community also makes the following non-binding requests: 00033 * 00034 * Any person wishing to distribute modifications to the Software is 00035 * requested to send the modifications to the original developer so that 00036 * they can be incorporated into the canonical version. It is also 00037 * requested that these non-binding requests be included along with the 00038 * license above. 00039 */ 00040 00047 #include "portaudio.h" 00048 #include "pa_win_waveformat.h" 00049 00050 #ifdef __cplusplus 00051 extern "C" 00052 { 00053 #endif /* __cplusplus */ 00054 00055 00056 #define paWinDirectSoundUseLowLevelLatencyParameters (0x01) 00057 #define paWinDirectSoundUseChannelMask (0x04) 00058 00059 00060 typedef struct PaWinDirectSoundStreamInfo{ 00061 unsigned long size; 00062 PaHostApiTypeId hostApiType; 00063 unsigned long version; 00065 unsigned long flags; 00066 00067 /* low-level latency setting support 00068 TODO ** NOT IMPLEMENTED ** 00069 These settings control the number and size of host buffers in order 00070 to set latency. They will be used instead of the generic parameters 00071 to Pa_OpenStream() if flags contains the paWinDirectSoundUseLowLevelLatencyParameters 00072 flag. 00073 00074 If PaWinDirectSoundStreamInfo structures with paWinDirectSoundUseLowLevelLatencyParameters 00075 are supplied for both input and output in a full duplex stream, then the 00076 input and output framesPerBuffer must be the same, or the larger of the 00077 two must be a multiple of the smaller, otherwise a 00078 paIncompatibleHostApiSpecificStreamInfo error will be returned from 00079 Pa_OpenStream(). 00080 00081 unsigned long framesPerBuffer; 00082 */ 00083 00084 /* 00085 support for WAVEFORMATEXTENSIBLE channel masks. If flags contains 00086 paWinDirectSoundUseChannelMask this allows you to specify which speakers 00087 to address in a multichannel stream. Constants for channelMask 00088 are specified in pa_win_waveformat.h 00089 00090 */ 00091 PaWinWaveFormatChannelMask channelMask; 00092 00093 }PaWinDirectSoundStreamInfo; 00094 00101 LPGUID PaWinDS_GetStreamInputGUID( PaStream* s ); 00102 00109 LPGUID PaWinDS_GetStreamOutputGUID( PaStream* s ); 00110 00111 00112 #ifdef __cplusplus 00113 } 00114 #endif /* __cplusplus */ 00115 00116 #endif /* PA_WIN_DS_H */