1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2005 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _MULTIMEDIA_AUDIODEVICE_H
#define _MULTIMEDIA_AUDIODEVICE_H
#pragma ident "%Z%%M% %I% %E% SMI"
#ifdef NO_EXTERN_C
#ifdef __cplusplus
extern "C" {
#endif
#endif /* NO_EXTERN_C */
#include <sys/ioccom.h>
#include <sys/audioio.h>
#include <AudioUnixfile.h>
// Enumerate known device types
enum AudioDeviceType {
AudioDeviceUnknown, // unknown device type
AudioDeviceAMD, // AM79C30
AudioDeviceSBPRO, // SoundBlaster Pro
AudioDeviceSB16, // SoundBlaster 16
AudioDeviceSPECTRUM, // MediaVision Audio Spectrum 16
AudioDeviceMULTISOUND, // Turtle Beach MultiSound
AudioDeviceCODEC // MMCodec with no DBRI
};
// The audio information structure is defined as a class so that
// it is automatically initialized whenever allocated.
class AudioInfo {
private:
audio_info_t info; // device info structure
public:
AudioInfo(); // Constructor
audio_info_t *operator ->() // Cast to info ptr
{ return (&info); }
void Clear(); // Reset
};
// Audio device encoding structure (play/record state)
typedef audio_prinfo_t AudioPRinfo;
// This is the 'base' class for audio devices
//
// Since audio devices can theoretically have separate input and output
// encoding formats, there are separate methods for input and output headers.
// For compatibility with other AudioStream classes, GetHeader() gets the
// input data encoding and SetHeader() sets the output data encoding.
class AudioDevice : public AudioUnixfile {
private:
static const FileAccess defmode; // Default access mode
static const char *AUDIO_ENV; // Default device env name
static const char *AUDIO_DEV; // Default device name
AudioHdr readhdr; // input data encoding
AudioDeviceType devtype; // device type
AudioDevice operator=(AudioDevice); // Assignment is illegal
protected:
// open with a given pathname
virtual AudioError tryopen(
const char *, int);
virtual void decode_devtype(); // figure out the device type
virtual void clearhdr(); // clear cached readhdr
virtual AudioError info_to_hdr(
const AudioPRinfo& prinfo, // device encoding info
AudioHdr& h) const; // header to set
virtual AudioError hdr_to_info(
const AudioHdr& h, // header to encode
AudioPRinfo& prinfo) const; // output device encoding info
virtual Double scale_gain(unsigned int); // gain -> float
virtual unsigned int unscale_gain(Double); // float -> gain
virtual Double scale_balance(unsigned int); // balance -> float
virtual unsigned int unscale_balance(Double); // float -> balance
// Turn SIGPOLL on/off
virtual AudioError incr_volume(
Boolean, // true to raise, false to lower
AudioInfo&, // info structure
unsigned int *); // ptr to gain field in info
// Check rate tolerance
virtual Boolean rate_match(
unsigned int, unsigned int);
// class AudioUnixfile methods specialized here
virtual AudioError decode_filehdr() // No-op for devices
{ return (AUDIO_ERR_BADARG); }
virtual AudioError encode_filehdr() // No-op for devices
{ return (AUDIO_ERR_BADARG); }
// class AudioStream methods specialized here
virtual Boolean opened() const; // TRUE, if open
public:
// Constructor with path
AudioDevice(
const char *path = "", // device name
const FileAccess acc = defmode); // access mode
virtual ~AudioDevice(); // Destructor
// class AudioUnixfile methods specialized here
virtual AudioError Create(); // Create file
virtual AudioError Open(); // Open file
// ... with search path
virtual AudioError OpenPath(
const char *path = AUDIO_ENV);
// Read from position
virtual AudioError ReadData(
void* buf, // buffer to fill
size_t& len, // buffer length (updated)
Double& pos); // start position (updated)
// Write at position
virtual AudioError WriteData(
void* buf, // buffer to copy
size_t& len, // buffer length (updated)
Double& pos); // start position (updated)
// class AudioStream methods specialized here
// Set header
virtual AudioError SetHeader(
const AudioHdr& h); // header to copy
// class Audio methods specialized here
virtual AudioHdr GetHeader(); // Get header
virtual Boolean isDevice() const { return (TRUE); }
// Device control and status functions
virtual AudioDeviceType GetDeviceType() const; // Get device type
// Get device state
virtual AudioError GetState(
AudioInfo& info) const;
// Set device state
virtual AudioError SetState(
AudioInfo& info);
// Turn SIGPOLL on/off
virtual AudioError SetSignal(
Boolean on);
// TRUE if device-compatible hdr
virtual Boolean CanSetHeader(
AudioHdr& h); // header to check
// Set input encoding
virtual AudioError SetReadHeader(
AudioHdr& h); // header to copy (updated)
// Set output encoding
virtual AudioError SetWriteHeader(
AudioHdr& h); // header to copy (updated)
virtual AudioHdr GetReadHeader(); // Get input encoding
virtual AudioHdr GetWriteHeader(); // Get output encoding
virtual AudioError WriteEof(); // Write eof sync flag
virtual AudioError Flush(const FileAccess); // Flush data
virtual AudioError DrainOutput(); // Wait for output
virtual AudioError Pause(const FileAccess); // Set pause flags
virtual AudioError Resume(const FileAccess); // Clear pause flags
virtual AudioError SetPlayEof(unsigned&); // Play eof counter
virtual AudioError SetPlaySamples(unsigned&); // Play sample count
virtual AudioError SetRecSamples(unsigned&); // Record sample count
virtual AudioError SetPlayError(Boolean&); // Play error flag
virtual AudioError SetRecError(Boolean&); // Record error flag
virtual AudioError SetPlayWaiting(); // Set Play waiting
virtual AudioError SetRecWaiting(); // Set Record waiting
virtual AudioError SetRecDelay(Double&); // Set Record delay
virtual AudioError SetPlayVolume(Double&); // Play volume
virtual AudioError PlayVolumeUp(); // Raise volume a notch
virtual AudioError PlayVolumeDown(); // Lower volume a notch
virtual AudioError SetRecVolume(Double&); // Record volume
virtual AudioError RecVolumeUp(); // Raise volume a notch
virtual AudioError RecVolumeDown(); // Lower volume a notch
virtual AudioError SetMonVolume(Double&); // Monitor volume
virtual AudioError MonVolumeUp(); // Raise volume a notch
virtual AudioError MonVolumeDown(); // Lower volume a notch
virtual AudioError SetPlayBalance(Double&); // Set balance
virtual AudioError SetRecBalance(Double&); // Set balance
virtual Double GetPlayVolume(AudioInfo* = 0); // Play volume
virtual Double GetRecVolume(AudioInfo* = 0); // Record volume
virtual Double GetMonVolume(AudioInfo* = 0); // Monitor volume
virtual Double GetPlayBalance(AudioInfo* = 0); // Play balance
virtual Double GetRecBalance(AudioInfo* = 0); // Record balance
virtual unsigned GetPlaySamples(AudioInfo* = 0); // Play sample count
virtual unsigned GetRecSamples(AudioInfo* = 0); // Record sample count
virtual Boolean GetPlayOpen(AudioInfo* = 0); // Get Play open flag
virtual Boolean GetRecOpen(AudioInfo* = 0); // Get Record open flag
virtual Boolean GetPlayWaiting(AudioInfo* = 0); // Get Play waiting
virtual Boolean GetRecWaiting(AudioInfo* = 0); // Get Record waiting
};
#ifdef NO_EXTERN_C
#ifdef __cplusplus
}
#endif
#endif /* NO_EXTERN_C */
#endif /* !_MULTIMEDIA_AUDIODEVICE_H */
|
