cannam@145: #ifndef PA_WIN_DS_H cannam@145: #define PA_WIN_DS_H cannam@145: /* cannam@145: * $Id: $ cannam@145: * PortAudio Portable Real-Time Audio Library cannam@145: * DirectSound specific extensions cannam@145: * cannam@145: * Copyright (c) 1999-2007 Ross Bencina and Phil Burk cannam@145: * cannam@145: * Permission is hereby granted, free of charge, to any person obtaining cannam@145: * a copy of this software and associated documentation files cannam@145: * (the "Software"), to deal in the Software without restriction, cannam@145: * including without limitation the rights to use, copy, modify, merge, cannam@145: * publish, distribute, sublicense, and/or sell copies of the Software, cannam@145: * and to permit persons to whom the Software is furnished to do so, cannam@145: * subject to the following conditions: cannam@145: * cannam@145: * The above copyright notice and this permission notice shall be cannam@145: * included in all copies or substantial portions of the Software. cannam@145: * cannam@145: * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, cannam@145: * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF cannam@145: * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. cannam@145: * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR cannam@145: * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF cannam@145: * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION cannam@145: * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. cannam@145: */ cannam@145: cannam@145: /* cannam@145: * The text above constitutes the entire PortAudio license; however, cannam@145: * the PortAudio community also makes the following non-binding requests: cannam@145: * cannam@145: * Any person wishing to distribute modifications to the Software is cannam@145: * requested to send the modifications to the original developer so that cannam@145: * they can be incorporated into the canonical version. It is also cannam@145: * requested that these non-binding requests be included along with the cannam@145: * license above. cannam@145: */ cannam@145: cannam@145: /** @file cannam@145: @ingroup public_header cannam@145: @brief DirectSound-specific PortAudio API extension header file. cannam@145: */ cannam@145: cannam@145: #include "portaudio.h" cannam@145: #include "pa_win_waveformat.h" cannam@145: cannam@145: #ifdef __cplusplus cannam@145: extern "C" cannam@145: { cannam@145: #endif /* __cplusplus */ cannam@145: cannam@145: cannam@145: #define paWinDirectSoundUseLowLevelLatencyParameters (0x01) cannam@145: #define paWinDirectSoundUseChannelMask (0x04) cannam@145: cannam@145: cannam@145: typedef struct PaWinDirectSoundStreamInfo{ cannam@145: unsigned long size; /**< sizeof(PaWinDirectSoundStreamInfo) */ cannam@145: PaHostApiTypeId hostApiType; /**< paDirectSound */ cannam@145: unsigned long version; /**< 2 */ cannam@145: cannam@145: unsigned long flags; /**< enable other features of this struct */ cannam@145: cannam@145: /** cannam@145: low-level latency setting support cannam@145: Sets the size of the DirectSound host buffer. cannam@145: When flags contains the paWinDirectSoundUseLowLevelLatencyParameters cannam@145: this size will be used instead of interpreting the generic latency cannam@145: parameters to Pa_OpenStream(). If the flag is not set this value is ignored. cannam@145: cannam@145: If the stream is a full duplex stream the implementation requires that cannam@145: the values of framesPerBuffer for input and output match (if both are specified). cannam@145: */ cannam@145: unsigned long framesPerBuffer; cannam@145: cannam@145: /** cannam@145: support for WAVEFORMATEXTENSIBLE channel masks. If flags contains cannam@145: paWinDirectSoundUseChannelMask this allows you to specify which speakers cannam@145: to address in a multichannel stream. Constants for channelMask cannam@145: are specified in pa_win_waveformat.h cannam@145: cannam@145: */ cannam@145: PaWinWaveFormatChannelMask channelMask; cannam@145: cannam@145: }PaWinDirectSoundStreamInfo; cannam@145: cannam@145: cannam@145: cannam@145: #ifdef __cplusplus cannam@145: } cannam@145: #endif /* __cplusplus */ cannam@145: cannam@145: #endif /* PA_WIN_DS_H */