annotate src/portaudio_20161030/include/pa_win_ds.h @ 151:fe80428a60a5

Add AppImage files
author Chris Cannam <cannam@all-day-breakfast.com>
date Tue, 26 Jun 2018 18:00:44 +0100
parents 59a8758c56b1
children
rev   line source
cannam@140 1 #ifndef PA_WIN_DS_H
cannam@140 2 #define PA_WIN_DS_H
cannam@140 3 /*
cannam@140 4 * $Id: $
cannam@140 5 * PortAudio Portable Real-Time Audio Library
cannam@140 6 * DirectSound specific extensions
cannam@140 7 *
cannam@140 8 * Copyright (c) 1999-2007 Ross Bencina and Phil Burk
cannam@140 9 *
cannam@140 10 * Permission is hereby granted, free of charge, to any person obtaining
cannam@140 11 * a copy of this software and associated documentation files
cannam@140 12 * (the "Software"), to deal in the Software without restriction,
cannam@140 13 * including without limitation the rights to use, copy, modify, merge,
cannam@140 14 * publish, distribute, sublicense, and/or sell copies of the Software,
cannam@140 15 * and to permit persons to whom the Software is furnished to do so,
cannam@140 16 * subject to the following conditions:
cannam@140 17 *
cannam@140 18 * The above copyright notice and this permission notice shall be
cannam@140 19 * included in all copies or substantial portions of the Software.
cannam@140 20 *
cannam@140 21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
cannam@140 22 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
cannam@140 23 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
cannam@140 24 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
cannam@140 25 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
cannam@140 26 * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
cannam@140 27 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
cannam@140 28 */
cannam@140 29
cannam@140 30 /*
cannam@140 31 * The text above constitutes the entire PortAudio license; however,
cannam@140 32 * the PortAudio community also makes the following non-binding requests:
cannam@140 33 *
cannam@140 34 * Any person wishing to distribute modifications to the Software is
cannam@140 35 * requested to send the modifications to the original developer so that
cannam@140 36 * they can be incorporated into the canonical version. It is also
cannam@140 37 * requested that these non-binding requests be included along with the
cannam@140 38 * license above.
cannam@140 39 */
cannam@140 40
cannam@140 41 /** @file
cannam@140 42 @ingroup public_header
cannam@140 43 @brief DirectSound-specific PortAudio API extension header file.
cannam@140 44 */
cannam@140 45
cannam@140 46 #include "portaudio.h"
cannam@140 47 #include "pa_win_waveformat.h"
cannam@140 48
cannam@140 49 #ifdef __cplusplus
cannam@140 50 extern "C"
cannam@140 51 {
cannam@140 52 #endif /* __cplusplus */
cannam@140 53
cannam@140 54
cannam@140 55 #define paWinDirectSoundUseLowLevelLatencyParameters (0x01)
cannam@140 56 #define paWinDirectSoundUseChannelMask (0x04)
cannam@140 57
cannam@140 58
cannam@140 59 typedef struct PaWinDirectSoundStreamInfo{
cannam@140 60 unsigned long size; /**< sizeof(PaWinDirectSoundStreamInfo) */
cannam@140 61 PaHostApiTypeId hostApiType; /**< paDirectSound */
cannam@140 62 unsigned long version; /**< 2 */
cannam@140 63
cannam@140 64 unsigned long flags; /**< enable other features of this struct */
cannam@140 65
cannam@140 66 /**
cannam@140 67 low-level latency setting support
cannam@140 68 Sets the size of the DirectSound host buffer.
cannam@140 69 When flags contains the paWinDirectSoundUseLowLevelLatencyParameters
cannam@140 70 this size will be used instead of interpreting the generic latency
cannam@140 71 parameters to Pa_OpenStream(). If the flag is not set this value is ignored.
cannam@140 72
cannam@140 73 If the stream is a full duplex stream the implementation requires that
cannam@140 74 the values of framesPerBuffer for input and output match (if both are specified).
cannam@140 75 */
cannam@140 76 unsigned long framesPerBuffer;
cannam@140 77
cannam@140 78 /**
cannam@140 79 support for WAVEFORMATEXTENSIBLE channel masks. If flags contains
cannam@140 80 paWinDirectSoundUseChannelMask this allows you to specify which speakers
cannam@140 81 to address in a multichannel stream. Constants for channelMask
cannam@140 82 are specified in pa_win_waveformat.h
cannam@140 83
cannam@140 84 */
cannam@140 85 PaWinWaveFormatChannelMask channelMask;
cannam@140 86
cannam@140 87 }PaWinDirectSoundStreamInfo;
cannam@140 88
cannam@140 89
cannam@140 90
cannam@140 91 #ifdef __cplusplus
cannam@140 92 }
cannam@140 93 #endif /* __cplusplus */
cannam@140 94
cannam@140 95 #endif /* PA_WIN_DS_H */