5
* PortAudio Portable Real-Time Audio Library
6
* DirectSound specific extensions
8
* Copyright (c) 1999-2007 Ross Bencina and Phil Burk
10
* Permission is hereby granted, free of charge, to any person obtaining
11
* a copy of this software and associated documentation files
12
* (the "Software"), to deal in the Software without restriction,
13
* including without limitation the rights to use, copy, modify, merge,
14
* publish, distribute, sublicense, and/or sell copies of the Software,
15
* and to permit persons to whom the Software is furnished to do so,
16
* subject to the following conditions:
18
* The above copyright notice and this permission notice shall be
19
* included in all copies or substantial portions of the Software.
21
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
22
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
23
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
24
* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
25
* ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
26
* CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
27
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
31
* The text above constitutes the entire PortAudio license; however,
32
* the PortAudio community also makes the following non-binding requests:
34
* Any person wishing to distribute modifications to the Software is
35
* requested to send the modifications to the original developer so that
36
* they can be incorporated into the canonical version. It is also
37
* requested that these non-binding requests be included along with the
42
@ingroup public_header
43
@brief DirectSound-specific PortAudio API extension header file.
47
#include "portaudio.h"
48
#include "pa_win_waveformat.h"
53
#endif /* __cplusplus */
56
#define paWinDirectSoundUseLowLevelLatencyParameters (0x01)
57
#define paWinDirectSoundUseChannelMask (0x04)
60
typedef struct PaWinDirectSoundStreamInfo{
61
unsigned long size; /**< sizeof(PaWinDirectSoundStreamInfo) */
62
PaHostApiTypeId hostApiType; /**< paDirectSound */
63
unsigned long version; /**< 1 */
67
/* low-level latency setting support
68
TODO ** NOT IMPLEMENTED **
69
These settings control the number and size of host buffers in order
70
to set latency. They will be used instead of the generic parameters
71
to Pa_OpenStream() if flags contains the paWinDirectSoundUseLowLevelLatencyParameters
74
If PaWinDirectSoundStreamInfo structures with paWinDirectSoundUseLowLevelLatencyParameters
75
are supplied for both input and output in a full duplex stream, then the
76
input and output framesPerBuffer must be the same, or the larger of the
77
two must be a multiple of the smaller, otherwise a
78
paIncompatibleHostApiSpecificStreamInfo error will be returned from
81
unsigned long framesPerBuffer;
85
support for WAVEFORMATEXTENSIBLE channel masks. If flags contains
86
paWinDirectSoundUseChannelMask this allows you to specify which speakers
87
to address in a multichannel stream. Constants for channelMask
88
are specified in pa_win_waveformat.h
91
PaWinWaveFormatChannelMask channelMask;
93
}PaWinDirectSoundStreamInfo;
99
#endif /* __cplusplus */
101
#endif /* PA_WIN_DS_H */