1 |
#ifndef PA_WIN_DS_H |
2 |
#define PA_WIN_DS_H |
3 |
/* |
4 |
* $Id: $ |
5 |
* PortAudio Portable Real-Time Audio Library |
6 |
* DirectSound specific extensions |
7 |
* |
8 |
* Copyright (c) 1999-2007 Ross Bencina and Phil Burk |
9 |
* |
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: |
17 |
* |
18 |
* The above copyright notice and this permission notice shall be |
19 |
* included in all copies or substantial portions of the Software. |
20 |
* |
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. |
28 |
*/ |
29 |
|
30 |
/* |
31 |
* The text above constitutes the entire PortAudio license; however, |
32 |
* the PortAudio community also makes the following non-binding requests: |
33 |
* |
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 |
38 |
* license above. |
39 |
*/ |
40 |
|
41 |
/** @file |
42 |
@ingroup public_header |
43 |
@brief DirectSound-specific PortAudio API extension header file. |
44 |
*/ |
45 |
|
46 |
|
47 |
#include "portaudio.h" |
48 |
#include "pa_win_waveformat.h" |
49 |
|
50 |
#ifdef __cplusplus |
51 |
extern "C" |
52 |
{ |
53 |
#endif /* __cplusplus */ |
54 |
|
55 |
|
56 |
#define paWinDirectSoundUseLowLevelLatencyParameters (0x01) |
57 |
#define paWinDirectSoundUseChannelMask (0x04) |
58 |
|
59 |
|
60 |
typedef struct PaWinDirectSoundStreamInfo{ |
61 |
unsigned long size; /**< sizeof(PaWinDirectSoundStreamInfo) */ |
62 |
PaHostApiTypeId hostApiType; /**< paDirectSound */ |
63 |
unsigned long version; /**< 1 */ |
64 |
|
65 |
unsigned long flags; |
66 |
|
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 |
72 |
flag. |
73 |
|
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 |
79 |
Pa_OpenStream(). |
80 |
|
81 |
unsigned long framesPerBuffer; |
82 |
*/ |
83 |
|
84 |
/* |
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 |
89 |
|
90 |
*/ |
91 |
PaWinWaveFormatChannelMask channelMask; |
92 |
|
93 |
}PaWinDirectSoundStreamInfo; |
94 |
|
95 |
|
96 |
|
97 |
#ifdef __cplusplus |
98 |
} |
99 |
#endif /* __cplusplus */ |
100 |
|
101 |
#endif /* PA_WIN_DS_H */ |