• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (c) 2007-2009 The Khronos Group Inc.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a copy of
5  * this software and /or associated documentation files (the "Materials "), to
6  * deal in the Materials without restriction, including without limitation the
7  * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
8  * sell copies of the Materials, and to permit persons to whom the Materials are
9  * furnished to do so, subject to
10  * the following conditions:
11  *
12  * The above copyright notice and this permission notice shall be included
13  * in all copies or substantial portions of the Materials.
14  *
15  * THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20  * OUT OF OR IN CONNECTION WITH THE MATERIALS OR THE USE OR OTHER DEALINGS IN THE
21  * MATERIALS.
22  *
23  * OpenSLES.h - OpenSL ES version 1.0.1
24  *
25  */
26 
27 /****************************************************************************/
28 /* NOTE: This file is a standard OpenSL ES header file and should not be    */
29 /* modified in any way.                                                     */
30 /****************************************************************************/
31 
32 #ifndef OPENSL_ES_H_
33 #define OPENSL_ES_H_
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38 
39 #include "OpenSLES_Platform.h"
40 
41 
42 /*****************************************************************************/
43 /* Common types, structures, and defines                                */
44 /*****************************************************************************/
45 
46 #ifndef _KHRONOS_KEYS_
47 #define _KHRONOS_KEYS_
48 
49 #define KHRONOS_TITLE "KhronosTitle"
50 #define KHRONOS_ALBUM "KhronosAlbum"
51 #define KHRONOS_TRACK_NUMBER "KhronosTrackNumber"
52 #define KHRONOS_ARTIST "KhronosArtist"
53 #define KHRONOS_GENRE "KhronosGenre"
54 #define KHRONOS_YEAR "KhronosYear"
55 #define KHRONOS_COMMENT "KhronosComment"
56 #define KHRONOS_ARTIST_URL "KhronosArtistURL"
57 #define KHRONOS_CONTENT_URL "KhronosContentURL"
58 #define KHRONOS_RATING "KhronosRating"
59 #define KHRONOS_ALBUM_ART "KhronosAlbumArt"
60 #define KHRONOS_COPYRIGHT "KhronosCopyright"
61 
62 #endif
63 
64 
65 /* remap common types to SL types for clarity */
66 typedef sl_int8_t              SLint8;          /* 8 bit signed integer  */
67 typedef sl_uint8_t             SLuint8;         /* 8 bit unsigned integer */
68 typedef sl_int16_t             SLint16;         /* 16 bit signed integer */
69 typedef sl_uint16_t            SLuint16;        /* 16 bit unsigned integer */
70 typedef sl_int32_t             SLint32;           /* 32 bit signed integer */
71 typedef sl_uint32_t            SLuint32;          /* 32 bit unsigned integer */
72 
73 typedef SLuint32                    SLboolean;
74 #define SL_BOOLEAN_FALSE            ((SLboolean) 0x00000000)
75 #define SL_BOOLEAN_TRUE             ((SLboolean) 0x00000001)
76 
77 typedef SLuint8						SLchar;			/* UTF-8 is to be used */
78 typedef SLint16						SLmillibel;
79 typedef SLuint32					SLmillisecond;
80 typedef SLuint32					SLmilliHertz;
81 typedef SLint32						SLmillimeter;
82 typedef SLint32						SLmillidegree;
83 typedef SLint16						SLpermille;
84 typedef SLuint32					SLmicrosecond;
85 typedef SLuint32					SLresult;
86 
87 #define SL_MILLIBEL_MAX 	((SLmillibel) 0x7FFF)
88 #define SL_MILLIBEL_MIN 	((SLmillibel) (-SL_MILLIBEL_MAX-1))
89 
90 #define SL_MILLIHERTZ_MAX	((SLmilliHertz) 0xFFFFFFFF)
91 #define SL_MILLIMETER_MAX	((SLmillimeter) 0x7FFFFFFF)
92 
93 /** Interface ID defined as a UUID */
94 typedef const struct SLInterfaceID_ {
95     SLuint32 time_low;
96     SLuint16 time_mid;
97     SLuint16 time_hi_and_version;
98     SLuint16 clock_seq;
99     SLuint8  node[6];
100 } * SLInterfaceID;
101 
102 /* Forward declaration for the object interface */
103 struct SLObjectItf_;
104 
105 typedef const struct SLObjectItf_ * const * SLObjectItf;
106 
107 /* Objects ID's */
108 
109 #define SL_OBJECTID_ENGINE			((SLuint32) 0x00001001)
110 #define SL_OBJECTID_LEDDEVICE		((SLuint32) 0x00001002)
111 #define SL_OBJECTID_VIBRADEVICE		((SLuint32) 0x00001003)
112 #define SL_OBJECTID_AUDIOPLAYER		((SLuint32) 0x00001004)
113 #define SL_OBJECTID_AUDIORECORDER	((SLuint32) 0x00001005)
114 #define SL_OBJECTID_MIDIPLAYER		((SLuint32) 0x00001006)
115 #define SL_OBJECTID_LISTENER		((SLuint32) 0x00001007)
116 #define SL_OBJECTID_3DGROUP			((SLuint32) 0x00001008)
117 #define SL_OBJECTID_OUTPUTMIX		((SLuint32) 0x00001009)
118 #define SL_OBJECTID_METADATAEXTRACTOR	((SLuint32) 0x0000100A)
119 
120 
121 /* SL Profiles */
122 
123 #define SL_PROFILES_PHONE	((SLuint16) 0x0001)
124 #define SL_PROFILES_MUSIC	((SLuint16) 0x0002)
125 #define SL_PROFILES_GAME	((SLuint16) 0x0004)
126 
127 /* Types of voices supported by the system */
128 
129 #define SL_VOICETYPE_2D_AUDIO		((SLuint16) 0x0001)
130 #define SL_VOICETYPE_MIDI			((SLuint16) 0x0002)
131 #define SL_VOICETYPE_3D_AUDIO 		((SLuint16) 0x0004)
132 #define SL_VOICETYPE_3D_MIDIOUTPUT 	((SLuint16) 0x0008)
133 
134 /* Convenient macros representing various different priority levels, for use with the SetPriority method */
135 
136 #define SL_PRIORITY_LOWEST		((SLint32) (-0x7FFFFFFF-1))
137 #define SL_PRIORITY_VERYLOW		((SLint32) -0x60000000)
138 #define SL_PRIORITY_LOW			((SLint32) -0x40000000)
139 #define SL_PRIORITY_BELOWNORMAL	((SLint32) -0x20000000)
140 #define SL_PRIORITY_NORMAL		((SLint32) 0x00000000)
141 #define SL_PRIORITY_ABOVENORMAL	((SLint32) 0x20000000)
142 #define SL_PRIORITY_HIGH		((SLint32) 0x40000000)
143 #define SL_PRIORITY_VERYHIGH	((SLint32) 0x60000000)
144 #define SL_PRIORITY_HIGHEST	((SLint32) 0x7FFFFFFF)
145 
146 
147 /** These macros list the various sample formats that are possible on audio input and output devices. */
148 
149 #define SL_PCMSAMPLEFORMAT_FIXED_8	((SLuint16) 0x0008)
150 #define SL_PCMSAMPLEFORMAT_FIXED_16	((SLuint16) 0x0010)
151 #define SL_PCMSAMPLEFORMAT_FIXED_20 	((SLuint16) 0x0014)
152 #define SL_PCMSAMPLEFORMAT_FIXED_24	((SLuint16) 0x0018)
153 #define SL_PCMSAMPLEFORMAT_FIXED_28 	((SLuint16) 0x001C)
154 #define SL_PCMSAMPLEFORMAT_FIXED_32	((SLuint16) 0x0020)
155 
156 
157 /** These macros specify the commonly used sampling rates (in milliHertz) supported by most audio I/O devices. */
158 
159 #define SL_SAMPLINGRATE_8		((SLuint32) 8000000)
160 #define SL_SAMPLINGRATE_11_025	((SLuint32) 11025000)
161 #define SL_SAMPLINGRATE_12		((SLuint32) 12000000)
162 #define SL_SAMPLINGRATE_16		((SLuint32) 16000000)
163 #define SL_SAMPLINGRATE_22_05	((SLuint32) 22050000)
164 #define SL_SAMPLINGRATE_24		((SLuint32) 24000000)
165 #define SL_SAMPLINGRATE_32		((SLuint32) 32000000)
166 #define SL_SAMPLINGRATE_44_1	((SLuint32) 44100000)
167 #define SL_SAMPLINGRATE_48		((SLuint32) 48000000)
168 #define SL_SAMPLINGRATE_64		((SLuint32) 64000000)
169 #define SL_SAMPLINGRATE_88_2	((SLuint32) 88200000)
170 #define SL_SAMPLINGRATE_96		((SLuint32) 96000000)
171 #define SL_SAMPLINGRATE_192	((SLuint32) 192000000)
172 
173 #define SL_SPEAKER_FRONT_LEFT			((SLuint32) 0x00000001)
174 #define SL_SPEAKER_FRONT_RIGHT			((SLuint32) 0x00000002)
175 #define SL_SPEAKER_FRONT_CENTER			((SLuint32) 0x00000004)
176 #define SL_SPEAKER_LOW_FREQUENCY			((SLuint32) 0x00000008)
177 #define SL_SPEAKER_BACK_LEFT			((SLuint32) 0x00000010)
178 #define SL_SPEAKER_BACK_RIGHT			((SLuint32) 0x00000020)
179 #define SL_SPEAKER_FRONT_LEFT_OF_CENTER	((SLuint32) 0x00000040)
180 #define SL_SPEAKER_FRONT_RIGHT_OF_CENTER	((SLuint32) 0x00000080)
181 #define SL_SPEAKER_BACK_CENTER			((SLuint32) 0x00000100)
182 #define SL_SPEAKER_SIDE_LEFT			((SLuint32) 0x00000200)
183 #define SL_SPEAKER_SIDE_RIGHT			((SLuint32) 0x00000400)
184 #define SL_SPEAKER_TOP_CENTER			((SLuint32) 0x00000800)
185 #define SL_SPEAKER_TOP_FRONT_LEFT		((SLuint32) 0x00001000)
186 #define SL_SPEAKER_TOP_FRONT_CENTER		((SLuint32) 0x00002000)
187 #define SL_SPEAKER_TOP_FRONT_RIGHT		((SLuint32) 0x00004000)
188 #define SL_SPEAKER_TOP_BACK_LEFT			((SLuint32) 0x00008000)
189 #define SL_SPEAKER_TOP_BACK_CENTER		((SLuint32) 0x00010000)
190 #define SL_SPEAKER_TOP_BACK_RIGHT		((SLuint32) 0x00020000)
191 
192 
193 /*****************************************************************************/
194 /* Errors                                                                    */
195 /*                                                                           */
196 /*****************************************************************************/
197 
198 #define SL_RESULT_SUCCESS				((SLuint32) 0x00000000)
199 #define SL_RESULT_PRECONDITIONS_VIOLATED	((SLuint32) 0x00000001)
200 #define SL_RESULT_PARAMETER_INVALID		((SLuint32) 0x00000002)
201 #define SL_RESULT_MEMORY_FAILURE			((SLuint32) 0x00000003)
202 #define SL_RESULT_RESOURCE_ERROR			((SLuint32) 0x00000004)
203 #define SL_RESULT_RESOURCE_LOST			((SLuint32) 0x00000005)
204 #define SL_RESULT_IO_ERROR				((SLuint32) 0x00000006)
205 #define SL_RESULT_BUFFER_INSUFFICIENT		((SLuint32) 0x00000007)
206 #define SL_RESULT_CONTENT_CORRUPTED		((SLuint32) 0x00000008)
207 #define SL_RESULT_CONTENT_UNSUPPORTED		((SLuint32) 0x00000009)
208 #define SL_RESULT_CONTENT_NOT_FOUND		((SLuint32) 0x0000000A)
209 #define SL_RESULT_PERMISSION_DENIED		((SLuint32) 0x0000000B)
210 #define SL_RESULT_FEATURE_UNSUPPORTED		((SLuint32) 0x0000000C)
211 #define SL_RESULT_INTERNAL_ERROR			((SLuint32) 0x0000000D)
212 #define SL_RESULT_UNKNOWN_ERROR			((SLuint32) 0x0000000E)
213 #define SL_RESULT_OPERATION_ABORTED		((SLuint32) 0x0000000F)
214 #define SL_RESULT_CONTROL_LOST			((SLuint32) 0x00000010)
215 
216 
217 /* Object state definitions */
218 
219 #define SL_OBJECT_STATE_UNREALIZED	((SLuint32) 0x00000001)
220 #define SL_OBJECT_STATE_REALIZED		((SLuint32) 0x00000002)
221 #define SL_OBJECT_STATE_SUSPENDED	((SLuint32) 0x00000003)
222 
223 /* Object event definitions */
224 
225 #define SL_OBJECT_EVENT_RUNTIME_ERROR			((SLuint32) 0x00000001)
226 #define SL_OBJECT_EVENT_ASYNC_TERMINATION		((SLuint32) 0x00000002)
227 #define SL_OBJECT_EVENT_RESOURCES_LOST			((SLuint32) 0x00000003)
228 #define SL_OBJECT_EVENT_RESOURCES_AVAILABLE		((SLuint32) 0x00000004)
229 #define SL_OBJECT_EVENT_ITF_CONTROL_TAKEN		((SLuint32) 0x00000005)
230 #define SL_OBJECT_EVENT_ITF_CONTROL_RETURNED		((SLuint32) 0x00000006)
231 #define SL_OBJECT_EVENT_ITF_PARAMETERS_CHANGED	((SLuint32) 0x00000007)
232 
233 
234 /*****************************************************************************/
235 /* Interface definitions                                                     */
236 /*****************************************************************************/
237 
238 /** NULL Interface */
239 
240 extern SL_API const SLInterfaceID SL_IID_NULL;
241 
242 /*---------------------------------------------------------------------------*/
243 /* Data Source and Data Sink Structures                                      */
244 /*---------------------------------------------------------------------------*/
245 
246 /** Data locator macros  */
247 #define SL_DATALOCATOR_URI			((SLuint32) 0x00000001)
248 #define SL_DATALOCATOR_ADDRESS		((SLuint32) 0x00000002)
249 #define SL_DATALOCATOR_IODEVICE		((SLuint32) 0x00000003)
250 #define SL_DATALOCATOR_OUTPUTMIX		((SLuint32) 0x00000004)
251 #define SL_DATALOCATOR_RESERVED5		((SLuint32) 0x00000005)
252 #define SL_DATALOCATOR_BUFFERQUEUE	((SLuint32) 0x00000006)
253 #define SL_DATALOCATOR_MIDIBUFFERQUEUE	((SLuint32) 0x00000007)
254 #define SL_DATALOCATOR_RESERVED8		((SLuint32) 0x00000008)
255 
256 
257 
258 /** URI-based data locator definition where locatorType must be SL_DATALOCATOR_URI*/
259 typedef struct SLDataLocator_URI_ {
260 	SLuint32 		locatorType;
261 	SLchar *		URI;
262 } SLDataLocator_URI;
263 
264 /** Address-based data locator definition where locatorType must be SL_DATALOCATOR_ADDRESS*/
265 typedef struct SLDataLocator_Address_ {
266 	SLuint32 	locatorType;
267 	void 		*pAddress;
268 	SLuint32	length;
269 } SLDataLocator_Address;
270 
271 /** IODevice-types */
272 #define SL_IODEVICE_AUDIOINPUT	((SLuint32) 0x00000001)
273 #define SL_IODEVICE_LEDARRAY	((SLuint32) 0x00000002)
274 #define SL_IODEVICE_VIBRA		((SLuint32) 0x00000003)
275 #define SL_IODEVICE_RESERVED4	((SLuint32) 0x00000004)
276 #define SL_IODEVICE_RESERVED5	((SLuint32) 0x00000005)
277 
278 /** IODevice-based data locator definition where locatorType must be SL_DATALOCATOR_IODEVICE*/
279 typedef struct SLDataLocator_IODevice_ {
280 	SLuint32	locatorType;
281 	SLuint32	deviceType;
282 	SLuint32	deviceID;
283 	SLObjectItf	device;
284 } SLDataLocator_IODevice;
285 
286 /** OutputMix-based data locator definition where locatorType must be SL_DATALOCATOR_OUTPUTMIX*/
287 typedef struct SLDataLocator_OutputMix {
288 	SLuint32 		locatorType;
289 	SLObjectItf		outputMix;
290 } SLDataLocator_OutputMix;
291 
292 
293 /** BufferQueue-based data locator definition where locatorType must be SL_DATALOCATOR_BUFFERQUEUE*/
294 typedef struct SLDataLocator_BufferQueue {
295 	SLuint32	locatorType;
296 	SLuint32	numBuffers;
297 } SLDataLocator_BufferQueue;
298 
299 /** MidiBufferQueue-based data locator definition where locatorType must be SL_DATALOCATOR_MIDIBUFFERQUEUE*/
300 typedef struct SLDataLocator_MIDIBufferQueue {
301 	SLuint32	locatorType;
302 	SLuint32	tpqn;
303 	SLuint32	numBuffers;
304 } SLDataLocator_MIDIBufferQueue;
305 
306 /** Data format defines */
307 #define SL_DATAFORMAT_MIME		((SLuint32) 0x00000001)
308 #define SL_DATAFORMAT_PCM		((SLuint32) 0x00000002)
309 #define SL_DATAFORMAT_RESERVED3	((SLuint32) 0x00000003)
310 
311 
312 /** MIME-type-based data format definition where formatType must be SL_DATAFORMAT_MIME*/
313 typedef struct SLDataFormat_MIME_ {
314 	SLuint32 		formatType;
315 	SLchar * 		mimeType;
316 	SLuint32		containerType;
317 } SLDataFormat_MIME;
318 
319 /* Byte order of a block of 16- or 32-bit data */
320 #define SL_BYTEORDER_BIGENDIAN				((SLuint32) 0x00000001)
321 #define SL_BYTEORDER_LITTLEENDIAN			((SLuint32) 0x00000002)
322 
323 /* Container type */
324 #define SL_CONTAINERTYPE_UNSPECIFIED	((SLuint32) 0x00000001)
325 #define SL_CONTAINERTYPE_RAW		((SLuint32) 0x00000002)
326 #define SL_CONTAINERTYPE_ASF		((SLuint32) 0x00000003)
327 #define SL_CONTAINERTYPE_AVI		((SLuint32) 0x00000004)
328 #define SL_CONTAINERTYPE_BMP		((SLuint32) 0x00000005)
329 #define SL_CONTAINERTYPE_JPG		((SLuint32) 0x00000006)
330 #define SL_CONTAINERTYPE_JPG2000		((SLuint32) 0x00000007)
331 #define SL_CONTAINERTYPE_M4A		((SLuint32) 0x00000008)
332 #define SL_CONTAINERTYPE_MP3		((SLuint32) 0x00000009)
333 #define SL_CONTAINERTYPE_MP4		((SLuint32) 0x0000000A)
334 #define SL_CONTAINERTYPE_MPEG_ES		((SLuint32) 0x0000000B)
335 #define SL_CONTAINERTYPE_MPEG_PS		((SLuint32) 0x0000000C)
336 #define SL_CONTAINERTYPE_MPEG_TS		((SLuint32) 0x0000000D)
337 #define SL_CONTAINERTYPE_QT		((SLuint32) 0x0000000E)
338 #define SL_CONTAINERTYPE_WAV		((SLuint32) 0x0000000F)
339 #define SL_CONTAINERTYPE_XMF_0		((SLuint32) 0x00000010)
340 #define SL_CONTAINERTYPE_XMF_1		((SLuint32) 0x00000011)
341 #define SL_CONTAINERTYPE_XMF_2		((SLuint32) 0x00000012)
342 #define SL_CONTAINERTYPE_XMF_3		((SLuint32) 0x00000013)
343 #define SL_CONTAINERTYPE_XMF_GENERIC	((SLuint32) 0x00000014)
344 #define SL_CONTAINERTYPE_AMR  		((SLuint32) 0x00000015)
345 #define SL_CONTAINERTYPE_AAC		((SLuint32) 0x00000016)
346 #define SL_CONTAINERTYPE_3GPP		((SLuint32) 0x00000017)
347 #define SL_CONTAINERTYPE_3GA		((SLuint32) 0x00000018)
348 #define SL_CONTAINERTYPE_RM		((SLuint32) 0x00000019)
349 #define SL_CONTAINERTYPE_DMF		((SLuint32) 0x0000001A)
350 #define SL_CONTAINERTYPE_SMF		((SLuint32) 0x0000001B)
351 #define SL_CONTAINERTYPE_MOBILE_DLS	((SLuint32) 0x0000001C)
352 #define SL_CONTAINERTYPE_OGG	((SLuint32) 0x0000001D)
353 
354 
355 /** PCM-type-based data format definition where formatType must be SL_DATAFORMAT_PCM*/
356 typedef struct SLDataFormat_PCM_ {
357 	SLuint32 		formatType;
358 	SLuint32 		numChannels;
359 	SLuint32 		samplesPerSec;
360 	SLuint32 		bitsPerSample;
361 	SLuint32 		containerSize;
362 	SLuint32 		channelMask;
363 	SLuint32		endianness;
364 } SLDataFormat_PCM;
365 
366 typedef struct SLDataSource_ {
367 	void *pLocator;
368 	void *pFormat;
369 } SLDataSource;
370 
371 
372 typedef struct SLDataSink_ {
373 	void *pLocator;
374 	void *pFormat;
375 } SLDataSink;
376 
377 
378 
379 
380 
381 
382 /*---------------------------------------------------------------------------*/
383 /* Standard Object Interface                                                 */
384 /*---------------------------------------------------------------------------*/
385 
386 extern SL_API const SLInterfaceID SL_IID_OBJECT;
387 
388 /** Object callback */
389 
390 
391 typedef void (SLAPIENTRY *slObjectCallback) (
392 	SLObjectItf caller,
393 	const void * pContext,
394 	SLuint32 event,
395 	SLresult result,
396     SLuint32 param,
397     void *pInterface
398 );
399 
400 
401 struct SLObjectItf_ {
402 	SLresult (*Realize) (
403 		SLObjectItf self,
404 		SLboolean async
405 	);
406 	SLresult (*Resume) (
407 		SLObjectItf self,
408 		SLboolean async
409 	);
410 	SLresult (*GetState) (
411 		SLObjectItf self,
412 		SLuint32 * pState
413 	);
414 	SLresult (*GetInterface) (
415 		SLObjectItf self,
416 		const SLInterfaceID iid,
417 		void * pInterface
418 	);
419 	SLresult (*RegisterCallback) (
420 		SLObjectItf self,
421 		slObjectCallback callback,
422 		void * pContext
423 	);
424 	void (*AbortAsyncOperation) (
425 		SLObjectItf self
426 	);
427 	void (*Destroy) (
428 		SLObjectItf self
429 	);
430 	SLresult (*SetPriority) (
431 		SLObjectItf self,
432 		SLint32 priority,
433 		SLboolean preemptable
434 	);
435 	SLresult (*GetPriority) (
436 		SLObjectItf self,
437 		SLint32 *pPriority,
438 		SLboolean *pPreemptable
439 	);
440 	SLresult (*SetLossOfControlInterfaces) (
441 		SLObjectItf self,
442 		SLint16 numInterfaces,
443 		SLInterfaceID * pInterfaceIDs,
444 		SLboolean enabled
445 	);
446 };
447 
448 
449 /*---------------------------------------------------------------------------*/
450 /* Audio IO Device capabilities interface                                    */
451 /*---------------------------------------------------------------------------*/
452 
453 #define SL_DEFAULTDEVICEID_AUDIOINPUT 	((SLuint32) 0xFFFFFFFF)
454 #define SL_DEFAULTDEVICEID_AUDIOOUTPUT 	((SLuint32) 0xFFFFFFFE)
455 #define SL_DEFAULTDEVICEID_LED          ((SLuint32) 0xFFFFFFFD)
456 #define SL_DEFAULTDEVICEID_VIBRA        ((SLuint32) 0xFFFFFFFC)
457 #define SL_DEFAULTDEVICEID_RESERVED1    ((SLuint32) 0xFFFFFFFB)
458 
459 
460 #define SL_DEVCONNECTION_INTEGRATED         ((SLint16) 0x0001)
461 #define SL_DEVCONNECTION_ATTACHED_WIRED     ((SLint16) 0x0100)
462 #define SL_DEVCONNECTION_ATTACHED_WIRELESS  ((SLint16) 0x0200)
463 #define SL_DEVCONNECTION_NETWORK 		    ((SLint16) 0x0400)
464 
465 
466 #define SL_DEVLOCATION_HANDSET 	((SLuint16) 0x0001)
467 #define SL_DEVLOCATION_HEADSET 	((SLuint16) 0x0002)
468 #define SL_DEVLOCATION_CARKIT 	((SLuint16) 0x0003)
469 #define SL_DEVLOCATION_DOCK 	((SLuint16) 0x0004)
470 #define SL_DEVLOCATION_REMOTE 	((SLuint16) 0x0005)
471 /* Note: SL_DEVLOCATION_RESLTE is deprecated, use SL_DEVLOCATION_REMOTE instead. */
472 #define SL_DEVLOCATION_RESLTE 	((SLuint16) 0x0005)
473 
474 
475 #define SL_DEVSCOPE_UNKNOWN     ((SLuint16) 0x0001)
476 #define SL_DEVSCOPE_ENVIRONMENT ((SLuint16) 0x0002)
477 #define SL_DEVSCOPE_USER        ((SLuint16) 0x0003)
478 
479 
480 typedef struct SLAudioInputDescriptor_ {
481 	SLchar *deviceName;
482 	SLint16 deviceConnection;
483 	SLint16 deviceScope;
484 	SLint16 deviceLocation;
485 	SLboolean isForTelephony;
486 	SLmilliHertz minSampleRate;
487 	SLmilliHertz maxSampleRate;
488 	SLboolean isFreqRangeContinuous;
489 	SLmilliHertz *samplingRatesSupported;
490 	SLint16 numOfSamplingRatesSupported;
491 	SLint16 maxChannels;
492 } SLAudioInputDescriptor;
493 
494 
495 typedef struct SLAudioOutputDescriptor_ {
496 	SLchar *pDeviceName;
497 	SLint16 deviceConnection;
498 	SLint16 deviceScope;
499 	SLint16 deviceLocation;
500 	SLboolean isForTelephony;
501 	SLmilliHertz minSampleRate;
502 	SLmilliHertz maxSampleRate;
503 	SLboolean isFreqRangeContinuous;
504 	SLmilliHertz *samplingRatesSupported;
505 	SLint16 numOfSamplingRatesSupported;
506 	SLint16 maxChannels;
507 } SLAudioOutputDescriptor;
508 
509 
510 
511 extern SL_API const SLInterfaceID SL_IID_AUDIOIODEVICECAPABILITIES;
512 
513 struct SLAudioIODeviceCapabilitiesItf_;
514 typedef const struct SLAudioIODeviceCapabilitiesItf_ * const * SLAudioIODeviceCapabilitiesItf;
515 
516 
517 typedef void (SLAPIENTRY *slAvailableAudioInputsChangedCallback) (
518 	SLAudioIODeviceCapabilitiesItf caller,
519 	void *pContext,
520 	SLuint32 deviceID,
521 	SLint32 numInputs,
522 	SLboolean isNew
523 );
524 
525 
526 typedef void (SLAPIENTRY *slAvailableAudioOutputsChangedCallback) (
527 	SLAudioIODeviceCapabilitiesItf caller,
528 	void *pContext,
529 	SLuint32 deviceID,
530 	SLint32 numOutputs,
531 	SLboolean isNew
532 );
533 
534 typedef void (SLAPIENTRY *slDefaultDeviceIDMapChangedCallback) (
535 	SLAudioIODeviceCapabilitiesItf caller,
536 	void *pContext,
537 	SLboolean isOutput,
538 	SLint32 numDevices
539 );
540 
541 
542 struct SLAudioIODeviceCapabilitiesItf_ {
543 	SLresult (*GetAvailableAudioInputs)(
544 		SLAudioIODeviceCapabilitiesItf self,
545 		SLint32  *pNumInputs,
546 		SLuint32 *pInputDeviceIDs
547 	);
548 	SLresult (*QueryAudioInputCapabilities)(
549 		SLAudioIODeviceCapabilitiesItf self,
550 		SLuint32 deviceId,
551 		SLAudioInputDescriptor *pDescriptor
552 	);
553 	SLresult (*RegisterAvailableAudioInputsChangedCallback) (
554 		SLAudioIODeviceCapabilitiesItf self,
555 		slAvailableAudioInputsChangedCallback callback,
556 		void *pContext
557 	);
558 	SLresult (*GetAvailableAudioOutputs)(
559 		SLAudioIODeviceCapabilitiesItf self,
560 		SLint32 *pNumOutputs,
561 		SLuint32 *pOutputDeviceIDs
562 	);
563 	SLresult (*QueryAudioOutputCapabilities)(
564 		SLAudioIODeviceCapabilitiesItf self,
565 		SLuint32 deviceId,
566 		SLAudioOutputDescriptor *pDescriptor
567 	);
568 	SLresult (*RegisterAvailableAudioOutputsChangedCallback) (
569 		SLAudioIODeviceCapabilitiesItf self,
570 		slAvailableAudioOutputsChangedCallback callback,
571 		void *pContext
572 	);
573 	SLresult (*RegisterDefaultDeviceIDMapChangedCallback) (
574 		SLAudioIODeviceCapabilitiesItf self,
575 		slDefaultDeviceIDMapChangedCallback callback,
576 		void *pContext
577 	);
578 	SLresult (*GetAssociatedAudioInputs) (
579 		SLAudioIODeviceCapabilitiesItf self,
580 		SLuint32 deviceId,
581 		SLint32 *pNumAudioInputs,
582 		SLuint32 *pAudioInputDeviceIDs
583 	);
584 	SLresult (*GetAssociatedAudioOutputs) (
585 		SLAudioIODeviceCapabilitiesItf self,
586 		SLuint32 deviceId,
587 		SLint32 *pNumAudioOutputs,
588 		SLuint32 *pAudioOutputDeviceIDs
589 	);
590 	SLresult (*GetDefaultAudioDevices) (
591 		SLAudioIODeviceCapabilitiesItf self,
592 		SLuint32 defaultDeviceID,
593 		SLint32 *pNumAudioDevices,
594 		SLuint32 *pAudioDeviceIDs
595 	);
596 	SLresult (*QuerySampleFormatsSupported)(
597 		SLAudioIODeviceCapabilitiesItf self,
598 		SLuint32 deviceId,
599 		SLmilliHertz samplingRate,
600 		SLint32 *pSampleFormats,
601 		SLint32 *pNumOfSampleFormats
602 	);
603 };
604 
605 
606 
607 /*---------------------------------------------------------------------------*/
608 /* Capabilities of the LED array IODevice                                    */
609 /*---------------------------------------------------------------------------*/
610 
611 typedef struct SLLEDDescriptor_ {
612 	SLuint8   ledCount;
613 	SLuint8   primaryLED;
614 	SLuint32  colorMask;
615 } SLLEDDescriptor;
616 
617 
618 /*---------------------------------------------------------------------------*/
619 /* LED Array interface                                                       */
620 /*---------------------------------------------------------------------------*/
621 
622 typedef struct SLHSL_ {
623     SLmillidegree  hue;
624     SLpermille     saturation;
625     SLpermille     lightness;
626 } SLHSL;
627 
628 
629 extern SL_API const SLInterfaceID SL_IID_LED;
630 
631 struct SLLEDArrayItf_;
632 typedef const struct SLLEDArrayItf_ * const * SLLEDArrayItf;
633 
634 struct SLLEDArrayItf_ {
635 	SLresult (*ActivateLEDArray) (
636 		SLLEDArrayItf self,
637 		SLuint32 lightMask
638 	);
639 	SLresult (*IsLEDArrayActivated) (
640 		SLLEDArrayItf self,
641 		SLuint32 *lightMask
642 	);
643 	SLresult (*SetColor) (
644 		SLLEDArrayItf self,
645 		SLuint8 index,
646 		const SLHSL *color
647 	);
648 	SLresult (*GetColor) (
649 		SLLEDArrayItf self,
650 		SLuint8 index,
651 		SLHSL *color
652 	);
653 };
654 
655 /*---------------------------------------------------------------------------*/
656 /* Capabilities of the Vibra IODevice                                        */
657 /*---------------------------------------------------------------------------*/
658 
659 typedef struct SLVibraDescriptor_ {
660 	SLboolean supportsFrequency;
661 	SLboolean supportsIntensity;
662 	SLmilliHertz  minFrequency;
663 	SLmilliHertz  maxFrequency;
664 } SLVibraDescriptor;
665 
666 
667 
668 /*---------------------------------------------------------------------------*/
669 /* Vibra interface                                                           */
670 /*---------------------------------------------------------------------------*/
671 
672 
673 extern SL_API const SLInterfaceID SL_IID_VIBRA;
674 
675 
676 struct SLVibraItf_;
677 typedef const struct SLVibraItf_ * const * SLVibraItf;
678 
679 struct SLVibraItf_ {
680 	SLresult (*Vibrate) (
681 		SLVibraItf self,
682 		SLboolean vibrate
683 	);
684 	SLresult (*IsVibrating) (
685 		SLVibraItf self,
686 		SLboolean *pVibrating
687 	);
688 	SLresult (*SetFrequency) (
689 		SLVibraItf self,
690 		SLmilliHertz frequency
691 	);
692 	SLresult (*GetFrequency) (
693 		SLVibraItf self,
694 		SLmilliHertz *pFrequency
695 	);
696 	SLresult (*SetIntensity) (
697 		SLVibraItf self,
698 		SLpermille intensity
699 	);
700 	SLresult (*GetIntensity) (
701 		SLVibraItf self,
702 		SLpermille *pIntensity
703 	);
704 };
705 
706 
707 /*---------------------------------------------------------------------------*/
708 /* Meta data extraction related types and interface                          */
709 /*---------------------------------------------------------------------------*/
710 
711 #define SL_CHARACTERENCODING_UNKNOWN			((SLuint32) 0x00000000)
712 #define SL_CHARACTERENCODING_BINARY       ((SLuint32) 0x00000001)
713 #define SL_CHARACTERENCODING_ASCII        ((SLuint32) 0x00000002)
714 #define SL_CHARACTERENCODING_BIG5         ((SLuint32) 0x00000003)
715 #define SL_CHARACTERENCODING_CODEPAGE1252		((SLuint32) 0x00000004)
716 #define SL_CHARACTERENCODING_GB2312			((SLuint32) 0x00000005)
717 #define SL_CHARACTERENCODING_HZGB2312			((SLuint32) 0x00000006)
718 #define SL_CHARACTERENCODING_GB12345			((SLuint32) 0x00000007)
719 #define SL_CHARACTERENCODING_GB18030			((SLuint32) 0x00000008)
720 #define SL_CHARACTERENCODING_GBK				((SLuint32) 0x00000009)
721 #define SL_CHARACTERENCODING_IMAPUTF7			((SLuint32) 0x0000000A)
722 #define SL_CHARACTERENCODING_ISO2022JP			((SLuint32) 0x0000000B)
723 #define SL_CHARACTERENCODING_ISO2022JP1		((SLuint32) 0x0000000B)
724 #define SL_CHARACTERENCODING_ISO88591			((SLuint32) 0x0000000C)
725 #define SL_CHARACTERENCODING_ISO885910			((SLuint32) 0x0000000D)
726 #define SL_CHARACTERENCODING_ISO885913			((SLuint32) 0x0000000E)
727 #define SL_CHARACTERENCODING_ISO885914			((SLuint32) 0x0000000F)
728 #define SL_CHARACTERENCODING_ISO885915			((SLuint32) 0x00000010)
729 #define SL_CHARACTERENCODING_ISO88592			((SLuint32) 0x00000011)
730 #define SL_CHARACTERENCODING_ISO88593			((SLuint32) 0x00000012)
731 #define SL_CHARACTERENCODING_ISO88594			((SLuint32) 0x00000013)
732 #define SL_CHARACTERENCODING_ISO88595			((SLuint32) 0x00000014)
733 #define SL_CHARACTERENCODING_ISO88596			((SLuint32) 0x00000015)
734 #define SL_CHARACTERENCODING_ISO88597			((SLuint32) 0x00000016)
735 #define SL_CHARACTERENCODING_ISO88598			((SLuint32) 0x00000017)
736 #define SL_CHARACTERENCODING_ISO88599			((SLuint32) 0x00000018)
737 #define SL_CHARACTERENCODING_ISOEUCJP			((SLuint32) 0x00000019)
738 #define SL_CHARACTERENCODING_SHIFTJIS			((SLuint32) 0x0000001A)
739 #define SL_CHARACTERENCODING_SMS7BIT			((SLuint32) 0x0000001B)
740 #define SL_CHARACTERENCODING_UTF7			((SLuint32) 0x0000001C)
741 #define SL_CHARACTERENCODING_UTF8			((SLuint32) 0x0000001D)
742 #define SL_CHARACTERENCODING_JAVACONFORMANTUTF8	((SLuint32) 0x0000001E)
743 #define SL_CHARACTERENCODING_UTF16BE			((SLuint32) 0x0000001F)
744 #define SL_CHARACTERENCODING_UTF16LE			((SLuint32) 0x00000020)
745 
746 
747 #define SL_METADATA_FILTER_KEY		((SLuint8) 0x01)
748 #define SL_METADATA_FILTER_LANG		((SLuint8) 0x02)
749 #define SL_METADATA_FILTER_ENCODING	((SLuint8) 0x04)
750 
751 
752 typedef struct SLMetadataInfo_ {
753     SLuint32     size;
754     SLuint32     encoding;
755     SLchar       langCountry[16];
756     SLuint8      data[1];
757 } SLMetadataInfo;
758 
759 extern SL_API const SLInterfaceID SL_IID_METADATAEXTRACTION;
760 
761 struct SLMetadataExtractionItf_;
762 typedef const struct SLMetadataExtractionItf_ * const * SLMetadataExtractionItf;
763 
764 
765 struct SLMetadataExtractionItf_ {
766 	SLresult (*GetItemCount) (
767 		SLMetadataExtractionItf self,
768 		SLuint32 *pItemCount
769 	);
770 	SLresult (*GetKeySize) (
771 		SLMetadataExtractionItf self,
772 		SLuint32 index,
773 		SLuint32 *pKeySize
774 	);
775 	SLresult (*GetKey) (
776 		SLMetadataExtractionItf self,
777 		SLuint32 index,
778 		SLuint32 keySize,
779 		SLMetadataInfo *pKey
780 	);
781 	SLresult (*GetValueSize) (
782 		SLMetadataExtractionItf self,
783 		SLuint32 index,
784 		SLuint32 *pValueSize
785 	);
786 	SLresult (*GetValue) (
787 		SLMetadataExtractionItf self,
788 		SLuint32 index,
789 		SLuint32 valueSize,
790 		SLMetadataInfo *pValue
791 	);
792 	SLresult (*AddKeyFilter) (
793 		SLMetadataExtractionItf self,
794 		SLuint32 keySize,
795 		const void *pKey,
796 		SLuint32 keyEncoding,
797 		const SLchar *pValueLangCountry,
798 		SLuint32 valueEncoding,
799 		SLuint8 filterMask
800 	);
801 	SLresult (*ClearKeyFilter) (
802 		SLMetadataExtractionItf self
803 	);
804 };
805 
806 
807 /*---------------------------------------------------------------------------*/
808 /* Meta data traversal related types and interface                          */
809 /*---------------------------------------------------------------------------*/
810 
811 #define SL_METADATATRAVERSALMODE_ALL	((SLuint32) 0x00000001)
812 #define SL_METADATATRAVERSALMODE_NODE	((SLuint32) 0x00000002)
813 
814 
815 #define SL_NODETYPE_UNSPECIFIED	((SLuint32) 0x00000001)
816 #define SL_NODETYPE_AUDIO		((SLuint32) 0x00000002)
817 #define SL_NODETYPE_VIDEO		((SLuint32) 0x00000003)
818 #define SL_NODETYPE_IMAGE		((SLuint32) 0x00000004)
819 
820 #define SL_NODE_PARENT 0xFFFFFFFF
821 
822 extern SL_API const SLInterfaceID SL_IID_METADATATRAVERSAL;
823 
824 struct SLMetadataTraversalItf_;
825 typedef const struct SLMetadataTraversalItf_ * const * SLMetadataTraversalItf;
826 
827 struct SLMetadataTraversalItf_ {
828 	SLresult (*SetMode) (
829 		SLMetadataTraversalItf self,
830 		SLuint32 mode
831 	);
832 	SLresult (*GetChildCount) (
833 		SLMetadataTraversalItf self,
834 		SLuint32 *pCount
835 	);
836 	SLresult (*GetChildMIMETypeSize) (
837 		SLMetadataTraversalItf self,
838 		SLuint32 index,
839 		SLuint32 *pSize
840 	);
841 	SLresult (*GetChildInfo) (
842 		SLMetadataTraversalItf self,
843 		SLuint32 index,
844 		SLint32 *pNodeID,
845 		SLuint32 *pType,
846 		SLuint32 size,
847 		SLchar *pMimeType
848 	);
849 	SLresult (*SetActiveNode) (
850 		SLMetadataTraversalItf self,
851 		SLuint32 index
852 	);
853 };
854 
855 /*---------------------------------------------------------------------------*/
856 /* Dynamic Source types and interface                                        */
857 /*---------------------------------------------------------------------------*/
858 
859 extern SL_API const SLInterfaceID SL_IID_DYNAMICSOURCE;
860 
861 struct SLDynamicSourceItf_;
862 typedef const struct SLDynamicSourceItf_ * const * SLDynamicSourceItf;
863 
864 struct SLDynamicSourceItf_ {
865 	SLresult (*SetSource) (
866 		SLDynamicSourceItf self,
867 		SLDataSource *pDataSource
868 	);
869 };
870 
871 /*---------------------------------------------------------------------------*/
872 /* Output Mix interface                                                      */
873 /*---------------------------------------------------------------------------*/
874 
875 extern SL_API const SLInterfaceID SL_IID_OUTPUTMIX;
876 
877 struct SLOutputMixItf_;
878 typedef const struct SLOutputMixItf_ * const * SLOutputMixItf;
879 
880 typedef void (SLAPIENTRY *slMixDeviceChangeCallback) (
881 	SLOutputMixItf caller,
882     void *pContext
883 );
884 
885 
886 struct SLOutputMixItf_ {
887 	SLresult (*GetDestinationOutputDeviceIDs) (
888 		SLOutputMixItf self,
889 		SLint32 *pNumDevices,
890 		SLuint32 *pDeviceIDs
891 	);
892 	SLresult (*RegisterDeviceChangeCallback) (
893 		SLOutputMixItf self,
894 		slMixDeviceChangeCallback callback,
895 		void *pContext
896     );
897     SLresult (*ReRoute)(
898         SLOutputMixItf self,
899         SLint32 numOutputDevices,
900         SLuint32 *pOutputDeviceIDs
901     );
902 };
903 
904 
905 /*---------------------------------------------------------------------------*/
906 /* Playback interface                                                        */
907 /*---------------------------------------------------------------------------*/
908 
909 /** Playback states */
910 #define SL_PLAYSTATE_STOPPED	((SLuint32) 0x00000001)
911 #define SL_PLAYSTATE_PAUSED	((SLuint32) 0x00000002)
912 #define SL_PLAYSTATE_PLAYING	((SLuint32) 0x00000003)
913 
914 /** Play events **/
915 #define SL_PLAYEVENT_HEADATEND		((SLuint32) 0x00000001)
916 #define SL_PLAYEVENT_HEADATMARKER	((SLuint32) 0x00000002)
917 #define SL_PLAYEVENT_HEADATNEWPOS	((SLuint32) 0x00000004)
918 #define SL_PLAYEVENT_HEADMOVING		((SLuint32) 0x00000008)
919 #define SL_PLAYEVENT_HEADSTALLED	((SLuint32) 0x00000010)
920 
921 #define SL_TIME_UNKNOWN	((SLuint32) 0xFFFFFFFF)
922 
923 
924 extern SL_API const SLInterfaceID SL_IID_PLAY;
925 
926 /** Playback interface methods */
927 
928 struct SLPlayItf_;
929 typedef const struct SLPlayItf_ * const * SLPlayItf;
930 
931 typedef void (SLAPIENTRY *slPlayCallback) (
932 	SLPlayItf caller,
933 	void *pContext,
934 	SLuint32 event
935 );
936 
937 struct SLPlayItf_ {
938 	SLresult (*SetPlayState) (
939 		SLPlayItf self,
940 		SLuint32 state
941 	);
942 	SLresult (*GetPlayState) (
943 		SLPlayItf self,
944 		SLuint32 *pState
945 	);
946 	SLresult (*GetDuration) (
947 		SLPlayItf self,
948 		SLmillisecond *pMsec
949 	);
950 	SLresult (*GetPosition) (
951 		SLPlayItf self,
952 		SLmillisecond *pMsec
953 	);
954 	SLresult (*RegisterCallback) (
955 		SLPlayItf self,
956 		slPlayCallback callback,
957 		void *pContext
958 	);
959 	SLresult (*SetCallbackEventsMask) (
960 		SLPlayItf self,
961 		SLuint32 eventFlags
962 	);
963 	SLresult (*GetCallbackEventsMask) (
964 		SLPlayItf self,
965 		SLuint32 *pEventFlags
966 	);
967 	SLresult (*SetMarkerPosition) (
968 		SLPlayItf self,
969 		SLmillisecond mSec
970 	);
971 	SLresult (*ClearMarkerPosition) (
972 		SLPlayItf self
973 	);
974 	SLresult (*GetMarkerPosition) (
975 		SLPlayItf self,
976 		SLmillisecond *pMsec
977 	);
978 	SLresult (*SetPositionUpdatePeriod) (
979 		SLPlayItf self,
980 		SLmillisecond mSec
981 	);
982 	SLresult (*GetPositionUpdatePeriod) (
983 		SLPlayItf self,
984 		SLmillisecond *pMsec
985 	);
986 };
987 
988 /*---------------------------------------------------------------------------*/
989 /* Prefetch status interface                                                 */
990 /*---------------------------------------------------------------------------*/
991 
992 #define SL_PREFETCHEVENT_STATUSCHANGE		((SLuint32) 0x00000001)
993 #define SL_PREFETCHEVENT_FILLLEVELCHANGE	((SLuint32) 0x00000002)
994 
995 #define SL_PREFETCHSTATUS_UNDERFLOW		((SLuint32) 0x00000001)
996 #define SL_PREFETCHSTATUS_SUFFICIENTDATA	((SLuint32) 0x00000002)
997 #define SL_PREFETCHSTATUS_OVERFLOW		((SLuint32) 0x00000003)
998 
999 
1000 extern SL_API const SLInterfaceID SL_IID_PREFETCHSTATUS;
1001 
1002 
1003 /** Prefetch status interface methods */
1004 
1005 struct SLPrefetchStatusItf_;
1006 typedef const struct SLPrefetchStatusItf_ * const * SLPrefetchStatusItf;
1007 
1008 typedef void (SLAPIENTRY *slPrefetchCallback) (
1009 	SLPrefetchStatusItf caller,
1010 	void *pContext,
1011 	SLuint32 event
1012 );
1013 
1014 struct SLPrefetchStatusItf_ {
1015 	SLresult (*GetPrefetchStatus) (
1016 		SLPrefetchStatusItf self,
1017 		SLuint32 *pStatus
1018 	);
1019 	SLresult (*GetFillLevel) (
1020 		SLPrefetchStatusItf self,
1021 		SLpermille *pLevel
1022 	);
1023 	SLresult (*RegisterCallback) (
1024 		SLPrefetchStatusItf self,
1025 		slPrefetchCallback callback,
1026 		void *pContext
1027 	);
1028 	SLresult (*SetCallbackEventsMask) (
1029 		SLPrefetchStatusItf self,
1030 		SLuint32 eventFlags
1031 	);
1032 	SLresult (*GetCallbackEventsMask) (
1033 		SLPrefetchStatusItf self,
1034 		SLuint32 *pEventFlags
1035 	);
1036 	SLresult (*SetFillUpdatePeriod) (
1037 		SLPrefetchStatusItf self,
1038 		SLpermille period
1039 	);
1040 	SLresult (*GetFillUpdatePeriod) (
1041 		SLPrefetchStatusItf self,
1042 		SLpermille *pPeriod
1043 	);
1044 };
1045 
1046 /*---------------------------------------------------------------------------*/
1047 /* Playback Rate interface                                                   */
1048 /*---------------------------------------------------------------------------*/
1049 
1050 #define SL_RATEPROP_RESERVED1		  		((SLuint32) 0x00000001)
1051 #define SL_RATEPROP_RESERVED2		  		((SLuint32) 0x00000002)
1052 #define SL_RATEPROP_SILENTAUDIO				((SLuint32) 0x00000100)
1053 #define SL_RATEPROP_STAGGEREDAUDIO	((SLuint32) 0x00000200)
1054 #define SL_RATEPROP_NOPITCHCORAUDIO	((SLuint32) 0x00000400)
1055 #define SL_RATEPROP_PITCHCORAUDIO	((SLuint32) 0x00000800)
1056 
1057 
1058 extern SL_API const SLInterfaceID SL_IID_PLAYBACKRATE;
1059 
1060 struct SLPlaybackRateItf_;
1061 typedef const struct SLPlaybackRateItf_ * const * SLPlaybackRateItf;
1062 
1063 struct SLPlaybackRateItf_ {
1064 	SLresult (*SetRate)(
1065 		SLPlaybackRateItf self,
1066 		SLpermille rate
1067 	);
1068 	SLresult (*GetRate)(
1069 		SLPlaybackRateItf self,
1070 		SLpermille *pRate
1071 	);
1072 	SLresult (*SetPropertyConstraints)(
1073 		SLPlaybackRateItf self,
1074 		SLuint32 constraints
1075 	);
1076 	SLresult (*GetProperties)(
1077 		SLPlaybackRateItf self,
1078 		SLuint32 *pProperties
1079 	);
1080 	SLresult (*GetCapabilitiesOfRate)(
1081 		SLPlaybackRateItf self,
1082 		SLpermille rate,
1083 		SLuint32 *pCapabilities
1084 	);
1085 	SLresult (*GetRateRange) (
1086 		SLPlaybackRateItf self,
1087 		SLuint8 index,
1088 		SLpermille *pMinRate,
1089 		SLpermille *pMaxRate,
1090 		SLpermille *pStepSize,
1091 		SLuint32 *pCapabilities
1092 	);
1093 };
1094 
1095 /*---------------------------------------------------------------------------*/
1096 /* Seek Interface                                                            */
1097 /*---------------------------------------------------------------------------*/
1098 
1099 #define SL_SEEKMODE_FAST		((SLuint32) 0x0001)
1100 #define SL_SEEKMODE_ACCURATE	((SLuint32) 0x0002)
1101 
1102 extern SL_API const SLInterfaceID SL_IID_SEEK;
1103 
1104 struct SLSeekItf_;
1105 typedef const struct SLSeekItf_ * const * SLSeekItf;
1106 
1107 struct SLSeekItf_ {
1108 	SLresult (*SetPosition)(
1109 		SLSeekItf self,
1110 		SLmillisecond pos,
1111 		SLuint32 seekMode
1112 	);
1113 	SLresult (*SetLoop)(
1114 		SLSeekItf self,
1115 		SLboolean loopEnable,
1116 		SLmillisecond startPos,
1117 		SLmillisecond endPos
1118 	);
1119 	SLresult (*GetLoop)(
1120 		SLSeekItf self,
1121 		SLboolean *pLoopEnabled,
1122 		SLmillisecond *pStartPos,
1123 		SLmillisecond *pEndPos
1124 	);
1125 };
1126 
1127 /*---------------------------------------------------------------------------*/
1128 /* Standard Recording Interface                                              */
1129 /*---------------------------------------------------------------------------*/
1130 
1131 /** Recording states */
1132 #define SL_RECORDSTATE_STOPPED 	((SLuint32) 0x00000001)
1133 #define SL_RECORDSTATE_PAUSED	((SLuint32) 0x00000002)
1134 #define SL_RECORDSTATE_RECORDING	((SLuint32) 0x00000003)
1135 
1136 
1137 /** Record event **/
1138 #define SL_RECORDEVENT_HEADATLIMIT	((SLuint32) 0x00000001)
1139 #define SL_RECORDEVENT_HEADATMARKER	((SLuint32) 0x00000002)
1140 #define SL_RECORDEVENT_HEADATNEWPOS	((SLuint32) 0x00000004)
1141 #define SL_RECORDEVENT_HEADMOVING	((SLuint32) 0x00000008)
1142 #define SL_RECORDEVENT_HEADSTALLED 	((SLuint32) 0x00000010)
1143 /* Note: SL_RECORDEVENT_BUFFER_INSUFFICIENT is deprecated, use SL_RECORDEVENT_BUFFER_FULL instead. */
1144 #define SL_RECORDEVENT_BUFFER_INSUFFICIENT      ((SLuint32) 0x00000020)
1145 #define SL_RECORDEVENT_BUFFER_FULL	((SLuint32) 0x00000020)
1146 
1147 
1148 extern SL_API const SLInterfaceID SL_IID_RECORD;
1149 
1150 struct SLRecordItf_;
1151 typedef const struct SLRecordItf_ * const * SLRecordItf;
1152 
1153 typedef void (SLAPIENTRY *slRecordCallback) (
1154 	SLRecordItf caller,
1155 	void *pContext,
1156 	SLuint32 event
1157 );
1158 
1159 /** Recording interface methods */
1160 struct SLRecordItf_ {
1161 	SLresult (*SetRecordState) (
1162 		SLRecordItf self,
1163 		SLuint32 state
1164 	);
1165 	SLresult (*GetRecordState) (
1166 		SLRecordItf self,
1167 		SLuint32 *pState
1168 	);
1169 	SLresult (*SetDurationLimit) (
1170 		SLRecordItf self,
1171 		SLmillisecond msec
1172 	);
1173 	SLresult (*GetPosition) (
1174 		SLRecordItf self,
1175 		SLmillisecond *pMsec
1176 	);
1177 	SLresult (*RegisterCallback) (
1178 		SLRecordItf self,
1179 		slRecordCallback callback,
1180 		void *pContext
1181 	);
1182 	SLresult (*SetCallbackEventsMask) (
1183 		SLRecordItf self,
1184 		SLuint32 eventFlags
1185 	);
1186 	SLresult (*GetCallbackEventsMask) (
1187 		SLRecordItf self,
1188 		SLuint32 *pEventFlags
1189 	);
1190 	SLresult (*SetMarkerPosition) (
1191 		SLRecordItf self,
1192 		SLmillisecond mSec
1193 	);
1194 	SLresult (*ClearMarkerPosition) (
1195 		SLRecordItf self
1196 	);
1197 	SLresult (*GetMarkerPosition) (
1198 		SLRecordItf self,
1199 		SLmillisecond *pMsec
1200 	);
1201 	SLresult (*SetPositionUpdatePeriod) (
1202 		SLRecordItf self,
1203 		SLmillisecond mSec
1204 	);
1205 	SLresult (*GetPositionUpdatePeriod) (
1206 		SLRecordItf self,
1207 		SLmillisecond *pMsec
1208 	);
1209 };
1210 
1211 /*---------------------------------------------------------------------------*/
1212 /* Equalizer interface                                                       */
1213 /*---------------------------------------------------------------------------*/
1214 
1215 #define SL_EQUALIZER_UNDEFINED				((SLuint16) 0xFFFF)
1216 
1217 extern SL_API const SLInterfaceID SL_IID_EQUALIZER;
1218 
1219 struct SLEqualizerItf_;
1220 typedef const struct SLEqualizerItf_ * const * SLEqualizerItf;
1221 
1222 struct SLEqualizerItf_ {
1223 	SLresult (*SetEnabled)(
1224 		SLEqualizerItf self,
1225 		SLboolean enabled
1226 	);
1227 	SLresult (*IsEnabled)(
1228 		SLEqualizerItf self,
1229 		SLboolean *pEnabled
1230 	);
1231 	SLresult (*GetNumberOfBands)(
1232 		SLEqualizerItf self,
1233 		SLuint16 *pAmount
1234 	);
1235 	SLresult (*GetBandLevelRange)(
1236 		SLEqualizerItf self,
1237 		SLmillibel *pMin,
1238 		SLmillibel *pMax
1239 	);
1240 	SLresult (*SetBandLevel)(
1241 		SLEqualizerItf self,
1242 		SLuint16 band,
1243 		SLmillibel level
1244 	);
1245 	SLresult (*GetBandLevel)(
1246 		SLEqualizerItf self,
1247 		SLuint16 band,
1248 		SLmillibel *pLevel
1249 	);
1250 	SLresult (*GetCenterFreq)(
1251 		SLEqualizerItf self,
1252 		SLuint16 band,
1253 		SLmilliHertz *pCenter
1254 	);
1255 	SLresult (*GetBandFreqRange)(
1256 		SLEqualizerItf self,
1257 		SLuint16 band,
1258 		SLmilliHertz *pMin,
1259 		SLmilliHertz *pMax
1260 	);
1261 	SLresult (*GetBand)(
1262 		SLEqualizerItf self,
1263 		SLmilliHertz frequency,
1264 		SLuint16 *pBand
1265 	);
1266 	SLresult (*GetCurrentPreset)(
1267 		SLEqualizerItf self,
1268 		SLuint16 *pPreset
1269 	);
1270 	SLresult (*UsePreset)(
1271 		SLEqualizerItf self,
1272 		SLuint16 index
1273 	);
1274 	SLresult (*GetNumberOfPresets)(
1275 		SLEqualizerItf self,
1276 		SLuint16 *pNumPresets
1277 	);
1278 	SLresult (*GetPresetName)(
1279 		SLEqualizerItf self,
1280 		SLuint16 index,
1281 		const SLchar ** ppName
1282 	);
1283 };
1284 
1285 /*---------------------------------------------------------------------------*/
1286 /* Volume Interface                                                           */
1287 /* --------------------------------------------------------------------------*/
1288 
1289 extern SL_API const SLInterfaceID SL_IID_VOLUME;
1290 
1291 struct SLVolumeItf_;
1292 typedef const struct SLVolumeItf_ * const * SLVolumeItf;
1293 
1294 struct SLVolumeItf_ {
1295 	SLresult (*SetVolumeLevel) (
1296 		SLVolumeItf self,
1297 		SLmillibel level
1298 	);
1299 	SLresult (*GetVolumeLevel) (
1300 		SLVolumeItf self,
1301 		SLmillibel *pLevel
1302 	);
1303 	SLresult (*GetMaxVolumeLevel) (
1304 		SLVolumeItf  self,
1305 		SLmillibel *pMaxLevel
1306 	);
1307 	SLresult (*SetMute) (
1308 		SLVolumeItf self,
1309 		SLboolean mute
1310 	);
1311 	SLresult (*GetMute) (
1312 		SLVolumeItf self,
1313 		SLboolean *pMute
1314 	);
1315 	SLresult (*EnableStereoPosition) (
1316 		SLVolumeItf self,
1317 		SLboolean enable
1318 	);
1319 	SLresult (*IsEnabledStereoPosition) (
1320 		SLVolumeItf self,
1321 		SLboolean *pEnable
1322 	);
1323 	SLresult (*SetStereoPosition) (
1324 		SLVolumeItf self,
1325 		SLpermille stereoPosition
1326 	);
1327 	SLresult (*GetStereoPosition) (
1328 		SLVolumeItf self,
1329 		SLpermille *pStereoPosition
1330 	);
1331 };
1332 
1333 
1334 /*---------------------------------------------------------------------------*/
1335 /* Device Volume Interface                                                   */
1336 /* --------------------------------------------------------------------------*/
1337 
1338 extern SL_API const SLInterfaceID SL_IID_DEVICEVOLUME;
1339 
1340 struct SLDeviceVolumeItf_;
1341 typedef const struct SLDeviceVolumeItf_ * const * SLDeviceVolumeItf;
1342 
1343 struct SLDeviceVolumeItf_ {
1344 	SLresult (*GetVolumeScale) (
1345 		SLDeviceVolumeItf self,
1346 		SLuint32 deviceID,
1347 		SLint32 *pMinValue,
1348 		SLint32 *pMaxValue,
1349 		SLboolean *pIsMillibelScale
1350 	);
1351 	SLresult (*SetVolume) (
1352 		SLDeviceVolumeItf self,
1353 		SLuint32 deviceID,
1354 		SLint32 volume
1355 	);
1356 	SLresult (*GetVolume) (
1357 		SLDeviceVolumeItf self,
1358 		SLuint32 deviceID,
1359 		SLint32 *pVolume
1360 	);
1361 };
1362 
1363 
1364 /*---------------------------------------------------------------------------*/
1365 /* Buffer Queue Interface                                                    */
1366 /*---------------------------------------------------------------------------*/
1367 
1368 extern SL_API const SLInterfaceID SL_IID_BUFFERQUEUE;
1369 
1370 struct SLBufferQueueItf_;
1371 typedef const struct SLBufferQueueItf_ * const * SLBufferQueueItf;
1372 
1373 typedef void (SLAPIENTRY *slBufferQueueCallback)(
1374 	SLBufferQueueItf caller,
1375 	void *pContext
1376 );
1377 
1378 /** Buffer queue state **/
1379 
1380 typedef struct SLBufferQueueState_ {
1381 	SLuint32	count;
1382 	SLuint32	playIndex;
1383 } SLBufferQueueState;
1384 
1385 
1386 struct SLBufferQueueItf_ {
1387 	SLresult (*Enqueue) (
1388 		SLBufferQueueItf self,
1389 		const void *pBuffer,
1390 		SLuint32 size
1391 	);
1392 	SLresult (*Clear) (
1393 		SLBufferQueueItf self
1394 	);
1395 	SLresult (*GetState) (
1396 		SLBufferQueueItf self,
1397 		SLBufferQueueState *pState
1398 	);
1399 	SLresult (*RegisterCallback) (
1400 		SLBufferQueueItf self,
1401 		slBufferQueueCallback callback,
1402 		void* pContext
1403 	);
1404 };
1405 
1406 
1407 /*---------------------------------------------------------------------------*/
1408 /* PresetReverb                                                              */
1409 /*---------------------------------------------------------------------------*/
1410 
1411 #define SL_REVERBPRESET_NONE		((SLuint16) 0x0000)
1412 #define SL_REVERBPRESET_SMALLROOM	((SLuint16) 0x0001)
1413 #define SL_REVERBPRESET_MEDIUMROOM	((SLuint16) 0x0002)
1414 #define SL_REVERBPRESET_LARGEROOM	((SLuint16) 0x0003)
1415 #define SL_REVERBPRESET_MEDIUMHALL	((SLuint16) 0x0004)
1416 #define SL_REVERBPRESET_LARGEHALL	((SLuint16) 0x0005)
1417 #define SL_REVERBPRESET_PLATE 		((SLuint16) 0x0006)
1418 
1419 
1420 extern SL_API const SLInterfaceID SL_IID_PRESETREVERB;
1421 
1422 struct SLPresetReverbItf_;
1423 typedef const struct SLPresetReverbItf_ * const * SLPresetReverbItf;
1424 
1425 struct SLPresetReverbItf_ {
1426 	SLresult (*SetPreset) (
1427 		SLPresetReverbItf self,
1428 		SLuint16 preset
1429 	);
1430 	SLresult (*GetPreset) (
1431 		SLPresetReverbItf self,
1432 		SLuint16 *pPreset
1433 	);
1434 };
1435 
1436 
1437 /*---------------------------------------------------------------------------*/
1438 /* EnvironmentalReverb                                                       */
1439 /*---------------------------------------------------------------------------*/
1440 
1441 #define SL_I3DL2_ENVIRONMENT_PRESET_DEFAULT \
1442 	{ SL_MILLIBEL_MIN,    0,  1000,   500, SL_MILLIBEL_MIN,  20, SL_MILLIBEL_MIN,  40, 1000,1000 }
1443 #define SL_I3DL2_ENVIRONMENT_PRESET_GENERIC \
1444 	{ -1000, -100, 1490,  830, -2602,   7,   200,  11, 1000,1000 }
1445 #define SL_I3DL2_ENVIRONMENT_PRESET_PADDEDCELL \
1446 	{ -1000,-6000,  170,  100, -1204,   1,   207,   2, 1000,1000 }
1447 #define SL_I3DL2_ENVIRONMENT_PRESET_ROOM \
1448 	{ -1000, -454,  400,  830, -1646,   2,    53,   3, 1000,1000 }
1449 #define SL_I3DL2_ENVIRONMENT_PRESET_BATHROOM \
1450 	{ -1000,-1200, 1490,  540,  -370,   7,  1030,  11, 1000, 600 }
1451 #define SL_I3DL2_ENVIRONMENT_PRESET_LIVINGROOM \
1452 	{ -1000,-6000,  500,  100, -1376,   3, -1104,   4, 1000,1000 }
1453 #define SL_I3DL2_ENVIRONMENT_PRESET_STONEROOM \
1454 	{ -1000, -300, 2310,  640,  -711,  12,    83,  17, 1000,1000 }
1455 #define SL_I3DL2_ENVIRONMENT_PRESET_AUDITORIUM \
1456 	{ -1000, -476, 4320,  590,  -789,  20,  -289,  30, 1000,1000 }
1457 #define SL_I3DL2_ENVIRONMENT_PRESET_CONCERTHALL \
1458 	{ -1000, -500, 3920,  700, -1230,  20,    -2,  29, 1000,1000 }
1459 #define SL_I3DL2_ENVIRONMENT_PRESET_CAVE \
1460 	{ -1000,    0, 2910, 1300,  -602,  15,  -302,  22, 1000,1000 }
1461 #define SL_I3DL2_ENVIRONMENT_PRESET_ARENA \
1462 	{ -1000, -698, 7240,  330, -1166,  20,    16,  30, 1000,1000 }
1463 #define SL_I3DL2_ENVIRONMENT_PRESET_HANGAR \
1464 	{ -1000,-1000, 10050,  230,  -602,  20,   198,  30, 1000,1000 }
1465 #define SL_I3DL2_ENVIRONMENT_PRESET_CARPETEDHALLWAY \
1466 	{ -1000,-4000,  300,  100, -1831,   2, -1630,  30, 1000,1000 }
1467 #define SL_I3DL2_ENVIRONMENT_PRESET_HALLWAY \
1468 	{ -1000, -300, 1490,  590, -1219,   7,   441,  11, 1000,1000 }
1469 #define SL_I3DL2_ENVIRONMENT_PRESET_STONECORRIDOR \
1470 	{ -1000, -237, 2700,  790, -1214,  13,   395,  20, 1000,1000 }
1471 #define SL_I3DL2_ENVIRONMENT_PRESET_ALLEY \
1472 	{ -1000, -270, 1490,  860, -1204,   7,    -4,  11, 1000,1000 }
1473 #define SL_I3DL2_ENVIRONMENT_PRESET_FOREST \
1474 	{ -1000,-3300, 1490,  540, -2560, 162,  -613,  88,  790,1000 }
1475 #define SL_I3DL2_ENVIRONMENT_PRESET_CITY \
1476 	{ -1000, -800, 1490,  670, -2273,   7, -2217,  11,  500,1000 }
1477 #define SL_I3DL2_ENVIRONMENT_PRESET_MOUNTAINS \
1478 	{ -1000,-2500, 1490,  210, -2780, 300, -2014, 100,  270,1000 }
1479 #define SL_I3DL2_ENVIRONMENT_PRESET_QUARRY \
1480 	{ -1000,-1000, 1490,  830, SL_MILLIBEL_MIN,  61,   500,  25, 1000,1000 }
1481 #define SL_I3DL2_ENVIRONMENT_PRESET_PLAIN \
1482 	{ -1000,-2000, 1490,  500, -2466, 179, -2514, 100,  210,1000 }
1483 #define SL_I3DL2_ENVIRONMENT_PRESET_PARKINGLOT \
1484 	{ -1000,    0, 1650, 1500, -1363,   8, -1153,  12, 1000,1000 }
1485 #define SL_I3DL2_ENVIRONMENT_PRESET_SEWERPIPE \
1486 	{ -1000,-1000, 2810,  140,   429,  14,   648,  21,  800, 600 }
1487 #define SL_I3DL2_ENVIRONMENT_PRESET_UNDERWATER \
1488 	{ -1000,-4000, 1490,  100,  -449,   7,  1700,  11, 1000,1000 }
1489 #define SL_I3DL2_ENVIRONMENT_PRESET_SMALLROOM \
1490 	{ -1000,-600, 1100, 830, -400, 5, 500, 10, 1000, 1000 }
1491 #define SL_I3DL2_ENVIRONMENT_PRESET_MEDIUMROOM \
1492 	{ -1000,-600, 1300, 830, -1000, 20, -200, 20, 1000, 1000 }
1493 #define SL_I3DL2_ENVIRONMENT_PRESET_LARGEROOM \
1494 	{ -1000,-600, 1500, 830, -1600, 5, -1000, 40, 1000, 1000 }
1495 #define SL_I3DL2_ENVIRONMENT_PRESET_MEDIUMHALL \
1496 	{ -1000,-600, 1800, 700, -1300, 15, -800, 30, 1000, 1000 }
1497 #define SL_I3DL2_ENVIRONMENT_PRESET_LARGEHALL \
1498 	{ -1000,-600, 1800, 700, -2000, 30, -1400, 60, 1000, 1000 }
1499 #define SL_I3DL2_ENVIRONMENT_PRESET_PLATE \
1500 	{ -1000,-200, 1300, 900, 0, 2, 0, 10, 1000, 750 }
1501 
1502 
1503 typedef struct SLEnvironmentalReverbSettings_ {
1504 	SLmillibel    roomLevel;
1505 	SLmillibel    roomHFLevel;
1506 	SLmillisecond decayTime;
1507 	SLpermille    decayHFRatio;
1508 	SLmillibel    reflectionsLevel;
1509 	SLmillisecond reflectionsDelay;
1510 	SLmillibel    reverbLevel;
1511 	SLmillisecond reverbDelay;
1512 	SLpermille    diffusion;
1513 	SLpermille    density;
1514 } SLEnvironmentalReverbSettings;
1515 
1516 
1517 
1518 
1519 extern SL_API const SLInterfaceID SL_IID_ENVIRONMENTALREVERB;
1520 
1521 
1522 struct SLEnvironmentalReverbItf_;
1523 typedef const struct SLEnvironmentalReverbItf_ * const * SLEnvironmentalReverbItf;
1524 
1525 struct SLEnvironmentalReverbItf_ {
1526 	SLresult (*SetRoomLevel) (
1527 		SLEnvironmentalReverbItf self,
1528 		SLmillibel room
1529 	);
1530 	SLresult (*GetRoomLevel) (
1531 		SLEnvironmentalReverbItf self,
1532 		SLmillibel *pRoom
1533 	);
1534 	SLresult (*SetRoomHFLevel) (
1535 		SLEnvironmentalReverbItf self,
1536 		SLmillibel roomHF
1537 	);
1538 	SLresult (*GetRoomHFLevel) (
1539 		SLEnvironmentalReverbItf self,
1540 		SLmillibel *pRoomHF
1541 	);
1542 	SLresult (*SetDecayTime) (
1543 		SLEnvironmentalReverbItf self,
1544 		SLmillisecond decayTime
1545 	);
1546 	SLresult (*GetDecayTime) (
1547 		SLEnvironmentalReverbItf self,
1548 		SLmillisecond *pDecayTime
1549 	);
1550 	SLresult (*SetDecayHFRatio) (
1551 		SLEnvironmentalReverbItf self,
1552 		SLpermille decayHFRatio
1553 	);
1554 	SLresult (*GetDecayHFRatio) (
1555 		SLEnvironmentalReverbItf self,
1556 		SLpermille *pDecayHFRatio
1557 	);
1558 	SLresult (*SetReflectionsLevel) (
1559 		SLEnvironmentalReverbItf self,
1560 		SLmillibel reflectionsLevel
1561 	);
1562 	SLresult (*GetReflectionsLevel) (
1563 		SLEnvironmentalReverbItf self,
1564 		SLmillibel *pReflectionsLevel
1565 	);
1566 	SLresult (*SetReflectionsDelay) (
1567 		SLEnvironmentalReverbItf self,
1568 		SLmillisecond reflectionsDelay
1569 	);
1570 	SLresult (*GetReflectionsDelay) (
1571 		SLEnvironmentalReverbItf self,
1572 		SLmillisecond *pReflectionsDelay
1573 	);
1574 	SLresult (*SetReverbLevel) (
1575 		SLEnvironmentalReverbItf self,
1576 		SLmillibel reverbLevel
1577 	);
1578 	SLresult (*GetReverbLevel) (
1579 		SLEnvironmentalReverbItf self,
1580 		SLmillibel *pReverbLevel
1581 	);
1582 	SLresult (*SetReverbDelay) (
1583 		SLEnvironmentalReverbItf self,
1584 		SLmillisecond reverbDelay
1585 	);
1586 	SLresult (*GetReverbDelay) (
1587 		SLEnvironmentalReverbItf self,
1588 		SLmillisecond *pReverbDelay
1589 	);
1590 	SLresult (*SetDiffusion) (
1591 		SLEnvironmentalReverbItf self,
1592 		SLpermille diffusion
1593 	);
1594 	SLresult (*GetDiffusion) (
1595 		SLEnvironmentalReverbItf self,
1596 		SLpermille *pDiffusion
1597 	);
1598 	SLresult (*SetDensity) (
1599 		SLEnvironmentalReverbItf self,
1600 		SLpermille density
1601 	);
1602 	SLresult (*GetDensity) (
1603 		SLEnvironmentalReverbItf self,
1604 		SLpermille *pDensity
1605 	);
1606 	SLresult (*SetEnvironmentalReverbProperties) (
1607 		SLEnvironmentalReverbItf self,
1608 		const SLEnvironmentalReverbSettings *pProperties
1609 	);
1610 	SLresult (*GetEnvironmentalReverbProperties) (
1611 		SLEnvironmentalReverbItf self,
1612 		SLEnvironmentalReverbSettings *pProperties
1613 	);
1614 };
1615 
1616 /*---------------------------------------------------------------------------*/
1617 /* Effects Send Interface                                                    */
1618 /*---------------------------------------------------------------------------*/
1619 
1620 
1621 extern SL_API const SLInterfaceID SL_IID_EFFECTSEND;
1622 
1623 struct SLEffectSendItf_;
1624 typedef const struct SLEffectSendItf_ * const * SLEffectSendItf;
1625 
1626 struct SLEffectSendItf_ {
1627 	SLresult (*EnableEffectSend) (
1628 		SLEffectSendItf self,
1629 		const void *pAuxEffect,
1630 		SLboolean enable,
1631 		SLmillibel initialLevel
1632 	);
1633 	SLresult (*IsEnabled) (
1634 		SLEffectSendItf self,
1635 		const void * pAuxEffect,
1636 		SLboolean *pEnable
1637 	);
1638 	SLresult (*SetDirectLevel) (
1639 		SLEffectSendItf self,
1640 		SLmillibel directLevel
1641 	);
1642 	SLresult (*GetDirectLevel) (
1643 		SLEffectSendItf self,
1644 		SLmillibel *pDirectLevel
1645 	);
1646 	SLresult (*SetSendLevel) (
1647 		SLEffectSendItf self,
1648 		const void *pAuxEffect,
1649 		SLmillibel sendLevel
1650 	);
1651 	SLresult (*GetSendLevel)(
1652 		SLEffectSendItf self,
1653 		const void *pAuxEffect,
1654 		SLmillibel *pSendLevel
1655 	);
1656 };
1657 
1658 
1659 /*---------------------------------------------------------------------------*/
1660 /* 3D Grouping Interface                                                     */
1661 /*---------------------------------------------------------------------------*/
1662 
1663 
1664 extern SL_API const SLInterfaceID SL_IID_3DGROUPING;
1665 
1666 
1667 struct SL3DGroupingItf_ ;
1668 typedef const struct SL3DGroupingItf_ * const * SL3DGroupingItf;
1669 
1670 struct SL3DGroupingItf_ {
1671 	SLresult (*Set3DGroup) (
1672 		SL3DGroupingItf self,
1673 		SLObjectItf group
1674 	);
1675 	SLresult (*Get3DGroup) (
1676 		SL3DGroupingItf self,
1677 		SLObjectItf *pGroup
1678 	);
1679 };
1680 
1681 
1682 /*---------------------------------------------------------------------------*/
1683 /* 3D Commit Interface                                                       */
1684 /*---------------------------------------------------------------------------*/
1685 
1686 
1687 extern SL_API const SLInterfaceID SL_IID_3DCOMMIT;
1688 
1689 struct SL3DCommitItf_;
1690 typedef const struct SL3DCommitItf_* const * SL3DCommitItf;
1691 
1692 struct SL3DCommitItf_ {
1693 	SLresult (*Commit) (
1694 		SL3DCommitItf self
1695 	);
1696 	SLresult (*SetDeferred) (
1697 		SL3DCommitItf self,
1698 		SLboolean deferred
1699 	);
1700 };
1701 
1702 
1703 /*---------------------------------------------------------------------------*/
1704 /* 3D Location Interface                                                     */
1705 /*---------------------------------------------------------------------------*/
1706 
1707 typedef struct SLVec3D_ {
1708 	SLint32	x;
1709 	SLint32	y;
1710 	SLint32	z;
1711 } SLVec3D;
1712 
1713 extern SL_API const SLInterfaceID SL_IID_3DLOCATION;
1714 
1715 struct SL3DLocationItf_;
1716 typedef const struct SL3DLocationItf_ * const * SL3DLocationItf;
1717 
1718 struct SL3DLocationItf_ {
1719 	SLresult (*SetLocationCartesian) (
1720 		SL3DLocationItf self,
1721 		const SLVec3D *pLocation
1722 	);
1723 	SLresult (*SetLocationSpherical) (
1724 		SL3DLocationItf self,
1725 		SLmillidegree azimuth,
1726 		SLmillidegree elevation,
1727 		SLmillimeter distance
1728 	);
1729 	SLresult (*Move) (
1730 		SL3DLocationItf self,
1731 		const SLVec3D *pMovement
1732 	);
1733 	SLresult (*GetLocationCartesian) (
1734 		SL3DLocationItf self,
1735 		SLVec3D *pLocation
1736 	);
1737 	SLresult (*SetOrientationVectors) (
1738 		SL3DLocationItf self,
1739 		const SLVec3D *pFront,
1740 		const SLVec3D *pAbove
1741 	);
1742 	SLresult (*SetOrientationAngles) (
1743 		SL3DLocationItf self,
1744 		SLmillidegree heading,
1745 		SLmillidegree pitch,
1746 		SLmillidegree roll
1747 	);
1748 	SLresult (*Rotate) (
1749 		SL3DLocationItf self,
1750 		SLmillidegree theta,
1751 		const SLVec3D *pAxis
1752 	);
1753 	SLresult (*GetOrientationVectors) (
1754 		SL3DLocationItf self,
1755 		SLVec3D *pFront,
1756 		SLVec3D *pUp
1757 	);
1758 };
1759 
1760 
1761 /*---------------------------------------------------------------------------*/
1762 /* 3D Doppler Interface                                                      */
1763 /*---------------------------------------------------------------------------*/
1764 
1765 
1766 extern SL_API const SLInterfaceID SL_IID_3DDOPPLER;
1767 
1768 struct SL3DDopplerItf_;
1769 typedef const struct SL3DDopplerItf_ * const * SL3DDopplerItf;
1770 
1771 struct SL3DDopplerItf_ {
1772 	SLresult (*SetVelocityCartesian) (
1773 		SL3DDopplerItf self,
1774 		const SLVec3D *pVelocity
1775 	);
1776 	SLresult (*SetVelocitySpherical) (
1777 		SL3DDopplerItf self,
1778 		SLmillidegree azimuth,
1779 		SLmillidegree elevation,
1780 		SLmillimeter speed
1781 	);
1782 	SLresult (*GetVelocityCartesian) (
1783 		SL3DDopplerItf self,
1784 		SLVec3D *pVelocity
1785 	);
1786 	SLresult (*SetDopplerFactor) (
1787 		SL3DDopplerItf self,
1788 		SLpermille dopplerFactor
1789 	);
1790 	SLresult (*GetDopplerFactor) (
1791 		SL3DDopplerItf self,
1792 		SLpermille *pDopplerFactor
1793 	);
1794 };
1795 
1796 /*---------------------------------------------------------------------------*/
1797 /* 3D Source Interface and associated defines                                */
1798 /* --------------------------------------------------------------------------*/
1799 
1800 #define SL_ROLLOFFMODEL_EXPONENTIAL	((SLuint32) 0x00000000)
1801 #define SL_ROLLOFFMODEL_LINEAR		((SLuint32) 0x00000001)
1802 
1803 
1804 extern SL_API const SLInterfaceID SL_IID_3DSOURCE;
1805 
1806 struct SL3DSourceItf_;
1807 typedef const struct SL3DSourceItf_ * const * SL3DSourceItf;
1808 
1809 struct SL3DSourceItf_ {
1810 	SLresult (*SetHeadRelative) (
1811 		SL3DSourceItf self,
1812 		SLboolean headRelative
1813 	);
1814 	SLresult (*GetHeadRelative) (
1815 		SL3DSourceItf self,
1816 		SLboolean *pHeadRelative
1817 	);
1818 	SLresult (*SetRolloffDistances) (
1819 		SL3DSourceItf self,
1820 		SLmillimeter minDistance,
1821 		SLmillimeter maxDistance
1822 	);
1823 	SLresult (*GetRolloffDistances) (
1824 		SL3DSourceItf self,
1825 		SLmillimeter *pMinDistance,
1826 		SLmillimeter *pMaxDistance
1827 	);
1828 	SLresult (*SetRolloffMaxDistanceMute) (
1829 		SL3DSourceItf self,
1830 		SLboolean mute
1831 	);
1832 	SLresult (*GetRolloffMaxDistanceMute) (
1833 		SL3DSourceItf self,
1834 		SLboolean *pMute
1835 	);
1836 	SLresult (*SetRolloffFactor) (
1837 		SL3DSourceItf self,
1838 		SLpermille rolloffFactor
1839 	);
1840 	SLresult (*GetRolloffFactor) (
1841 		SL3DSourceItf self,
1842 		SLpermille *pRolloffFactor
1843 	);
1844 	SLresult (*SetRoomRolloffFactor) (
1845 		SL3DSourceItf self,
1846 		SLpermille roomRolloffFactor
1847 	);
1848 	SLresult (*GetRoomRolloffFactor) (
1849 		SL3DSourceItf self,
1850 		SLpermille *pRoomRolloffFactor
1851 	);
1852 	SLresult (*SetRolloffModel) (
1853 		SL3DSourceItf self,
1854 		SLuint8 model
1855 	);
1856 	SLresult (*GetRolloffModel) (
1857 		SL3DSourceItf self,
1858 		SLuint8 *pModel
1859 	);
1860 	SLresult (*SetCone) (
1861 		SL3DSourceItf self,
1862 		SLmillidegree innerAngle,
1863 		SLmillidegree outerAngle,
1864 		SLmillibel outerLevel
1865 	);
1866 	SLresult (*GetCone) (
1867 		SL3DSourceItf self,
1868 		SLmillidegree *pInnerAngle,
1869 		SLmillidegree *pOuterAngle,
1870 		SLmillibel *pOuterLevel
1871 	);
1872 };
1873 
1874 /*---------------------------------------------------------------------------*/
1875 /* 3D Macroscopic Interface                                                  */
1876 /* --------------------------------------------------------------------------*/
1877 
1878 extern SL_API const SLInterfaceID SL_IID_3DMACROSCOPIC;
1879 
1880 struct SL3DMacroscopicItf_;
1881 typedef const struct SL3DMacroscopicItf_ * const * SL3DMacroscopicItf;
1882 
1883 struct SL3DMacroscopicItf_ {
1884 	SLresult (*SetSize) (
1885 		SL3DMacroscopicItf self,
1886 		SLmillimeter width,
1887 		SLmillimeter height,
1888 		SLmillimeter depth
1889 	);
1890 	SLresult (*GetSize) (
1891 		SL3DMacroscopicItf self,
1892 		SLmillimeter *pWidth,
1893 		SLmillimeter *pHeight,
1894 		SLmillimeter *pDepth
1895 	);
1896 	SLresult (*SetOrientationAngles) (
1897 		SL3DMacroscopicItf self,
1898 		SLmillidegree heading,
1899 		SLmillidegree pitch,
1900 		SLmillidegree roll
1901 	);
1902 	SLresult (*SetOrientationVectors) (
1903 		SL3DMacroscopicItf self,
1904 		const SLVec3D *pFront,
1905 		const SLVec3D *pAbove
1906 	);
1907 	SLresult (*Rotate) (
1908 		SL3DMacroscopicItf self,
1909 		SLmillidegree theta,
1910 		const SLVec3D *pAxis
1911 	);
1912 	SLresult (*GetOrientationVectors) (
1913 		SL3DMacroscopicItf self,
1914 		SLVec3D *pFront,
1915 		SLVec3D *pUp
1916 	);
1917 };
1918 
1919 /*---------------------------------------------------------------------------*/
1920 /* Mute Solo Interface                                                       */
1921 /* --------------------------------------------------------------------------*/
1922 
1923 
1924 extern SL_API const SLInterfaceID SL_IID_MUTESOLO;
1925 
1926 struct SLMuteSoloItf_;
1927 typedef const struct SLMuteSoloItf_ * const * SLMuteSoloItf;
1928 
1929 struct SLMuteSoloItf_ {
1930 	SLresult (*SetChannelMute) (
1931 		SLMuteSoloItf self,
1932 		SLuint8 chan,
1933 		SLboolean mute
1934 	);
1935 	SLresult (*GetChannelMute) (
1936 		SLMuteSoloItf self,
1937 		SLuint8 chan,
1938 		SLboolean *pMute
1939 	);
1940 	SLresult (*SetChannelSolo) (
1941 		SLMuteSoloItf self,
1942 		SLuint8 chan,
1943 		SLboolean solo
1944 	);
1945 	SLresult (*GetChannelSolo) (
1946 		SLMuteSoloItf self,
1947 		SLuint8 chan,
1948 		SLboolean *pSolo
1949 	);
1950 	SLresult (*GetNumChannels) (
1951 		SLMuteSoloItf self,
1952 		SLuint8 *pNumChannels
1953 	);
1954 };
1955 
1956 
1957 /*---------------------------------------------------------------------------*/
1958 /* Dynamic Interface Management Interface and associated types and macros    */
1959 /* --------------------------------------------------------------------------*/
1960 
1961 #define SL_DYNAMIC_ITF_EVENT_RUNTIME_ERROR			((SLuint32) 0x00000001)
1962 #define SL_DYNAMIC_ITF_EVENT_ASYNC_TERMINATION		((SLuint32) 0x00000002)
1963 #define SL_DYNAMIC_ITF_EVENT_RESOURCES_LOST			((SLuint32) 0x00000003)
1964 #define SL_DYNAMIC_ITF_EVENT_RESOURCES_LOST_PERMANENTLY	((SLuint32) 0x00000004)
1965 #define SL_DYNAMIC_ITF_EVENT_RESOURCES_AVAILABLE		((SLuint32) 0x00000005)
1966 
1967 
1968 
1969 
1970 extern SL_API const SLInterfaceID SL_IID_DYNAMICINTERFACEMANAGEMENT;
1971 
1972 struct SLDynamicInterfaceManagementItf_;
1973 typedef const struct SLDynamicInterfaceManagementItf_ * const * SLDynamicInterfaceManagementItf;
1974 
1975 typedef void (SLAPIENTRY *slDynamicInterfaceManagementCallback) (
1976 	SLDynamicInterfaceManagementItf caller,
1977 	void * pContext,
1978 	SLuint32 event,
1979 	SLresult result,
1980     const SLInterfaceID iid
1981 );
1982 
1983 
1984 struct SLDynamicInterfaceManagementItf_ {
1985 	SLresult (*AddInterface) (
1986 		SLDynamicInterfaceManagementItf self,
1987 		const SLInterfaceID iid,
1988 		SLboolean async
1989 	);
1990 	SLresult (*RemoveInterface) (
1991 		SLDynamicInterfaceManagementItf self,
1992 		const SLInterfaceID iid
1993 	);
1994 	SLresult (*ResumeInterface) (
1995 		SLDynamicInterfaceManagementItf self,
1996 		const SLInterfaceID iid,
1997 		SLboolean async
1998 	);
1999 	SLresult (*RegisterCallback) (
2000 		SLDynamicInterfaceManagementItf self,
2001 		slDynamicInterfaceManagementCallback callback,
2002 		void * pContext
2003 	);
2004 };
2005 
2006 /*---------------------------------------------------------------------------*/
2007 /* Midi Message Interface and associated types                               */
2008 /* --------------------------------------------------------------------------*/
2009 
2010 #define SL_MIDIMESSAGETYPE_NOTE_ON_OFF		((SLuint32) 0x00000001)
2011 #define SL_MIDIMESSAGETYPE_POLY_PRESSURE	((SLuint32) 0x00000002)
2012 #define SL_MIDIMESSAGETYPE_CONTROL_CHANGE	((SLuint32) 0x00000003)
2013 #define SL_MIDIMESSAGETYPE_PROGRAM_CHANGE	((SLuint32) 0x00000004)
2014 #define SL_MIDIMESSAGETYPE_CHANNEL_PRESSURE	((SLuint32) 0x00000005)
2015 #define SL_MIDIMESSAGETYPE_PITCH_BEND		((SLuint32) 0x00000006)
2016 #define SL_MIDIMESSAGETYPE_SYSTEM_MESSAGE	((SLuint32) 0x00000007)
2017 
2018 
2019 extern SL_API const SLInterfaceID SL_IID_MIDIMESSAGE;
2020 
2021 struct SLMIDIMessageItf_;
2022 typedef const struct SLMIDIMessageItf_ * const * SLMIDIMessageItf;
2023 
2024 typedef void (SLAPIENTRY *slMetaEventCallback) (
2025 	SLMIDIMessageItf caller,
2026 	void *pContext,
2027 	SLuint8 type,
2028     SLuint32 length,
2029 	const SLuint8 *pData,
2030 	SLuint32 tick,
2031 	SLuint16 track
2032 );
2033 
2034 typedef void (SLAPIENTRY *slMIDIMessageCallback) (
2035 	SLMIDIMessageItf caller,
2036 	void *pContext,
2037 	SLuint8 statusByte,
2038 	SLuint32 length,
2039 	const SLuint8 *pData,
2040 	SLuint32 tick,
2041 	SLuint16 track
2042 );
2043 
2044 struct SLMIDIMessageItf_ {
2045 	SLresult (*SendMessage) (
2046 		SLMIDIMessageItf self,
2047 		const SLuint8 *data,
2048 		SLuint32 length
2049 	);
2050 	SLresult (*RegisterMetaEventCallback) (
2051 		SLMIDIMessageItf self,
2052 		slMetaEventCallback callback,
2053 		void *pContext
2054 	);
2055 	SLresult (*RegisterMIDIMessageCallback) (
2056 		SLMIDIMessageItf self,
2057 		slMIDIMessageCallback callback,
2058 		void *pContext
2059 	);
2060 	SLresult (*AddMIDIMessageCallbackFilter) (
2061 		SLMIDIMessageItf self,
2062 		SLuint32 messageType
2063 	);
2064 	SLresult (*ClearMIDIMessageCallbackFilter) (
2065 		SLMIDIMessageItf self
2066 	);
2067 };
2068 
2069 
2070 /*---------------------------------------------------------------------------*/
2071 /* Midi Mute Solo interface                                                  */
2072 /* --------------------------------------------------------------------------*/
2073 
2074 
2075 extern SL_API const SLInterfaceID SL_IID_MIDIMUTESOLO;
2076 
2077 struct SLMIDIMuteSoloItf_;
2078 typedef const struct SLMIDIMuteSoloItf_ * const * SLMIDIMuteSoloItf;
2079 
2080 struct SLMIDIMuteSoloItf_ {
2081 	SLresult (*SetChannelMute) (
2082 		SLMIDIMuteSoloItf self,
2083 		SLuint8 channel,
2084 		SLboolean mute
2085 	);
2086 	SLresult (*GetChannelMute) (
2087 		SLMIDIMuteSoloItf self,
2088 		SLuint8 channel,
2089 		SLboolean *pMute
2090 	);
2091 	SLresult (*SetChannelSolo) (
2092 		SLMIDIMuteSoloItf self,
2093 		SLuint8 channel,
2094 		SLboolean solo
2095 	);
2096 	SLresult (*GetChannelSolo) (
2097 		SLMIDIMuteSoloItf self,
2098 		SLuint8 channel,
2099 		SLboolean *pSolo
2100 	);
2101 	SLresult (*GetTrackCount) (
2102 		SLMIDIMuteSoloItf self,
2103 		SLuint16 *pCount
2104 	);
2105 	SLresult (*SetTrackMute) (
2106 		SLMIDIMuteSoloItf self,
2107 		SLuint16 track,
2108 		SLboolean mute
2109 	);
2110 	SLresult (*GetTrackMute) (
2111 		SLMIDIMuteSoloItf self,
2112 		SLuint16 track,
2113 		SLboolean *pMute
2114 	);
2115 	SLresult (*SetTrackSolo) (
2116 		SLMIDIMuteSoloItf self,
2117 		SLuint16 track,
2118 		SLboolean solo
2119 	);
2120 	SLresult (*GetTrackSolo) (
2121 		SLMIDIMuteSoloItf self,
2122 		SLuint16 track,
2123 		SLboolean *pSolo
2124 	);
2125 };
2126 
2127 
2128 /*---------------------------------------------------------------------------*/
2129 /* Midi Tempo interface                                                      */
2130 /* --------------------------------------------------------------------------*/
2131 
2132 
2133 extern SL_API const SLInterfaceID SL_IID_MIDITEMPO;
2134 
2135 struct SLMIDITempoItf_;
2136 typedef const struct SLMIDITempoItf_ * const * SLMIDITempoItf;
2137 
2138 struct SLMIDITempoItf_ {
2139 	SLresult (*SetTicksPerQuarterNote) (
2140 		SLMIDITempoItf self,
2141 		SLuint32 tpqn
2142 	);
2143 	SLresult (*GetTicksPerQuarterNote) (
2144 		SLMIDITempoItf self,
2145 		SLuint32 *pTpqn
2146 	);
2147 	SLresult (*SetMicrosecondsPerQuarterNote) (
2148 		SLMIDITempoItf self,
2149 		SLmicrosecond uspqn
2150 	);
2151 	SLresult (*GetMicrosecondsPerQuarterNote) (
2152 		SLMIDITempoItf self,
2153 		SLmicrosecond *uspqn
2154 	);
2155 };
2156 
2157 
2158 /*---------------------------------------------------------------------------*/
2159 /* Midi Time interface                                                       */
2160 /* --------------------------------------------------------------------------*/
2161 
2162 
2163 extern SL_API const SLInterfaceID SL_IID_MIDITIME;
2164 
2165 struct SLMIDITimeItf_;
2166 typedef const struct SLMIDITimeItf_ * const * SLMIDITimeItf;
2167 
2168 struct SLMIDITimeItf_ {
2169 	SLresult (*GetDuration) (
2170 		SLMIDITimeItf self,
2171 		SLuint32 *pDuration
2172 	);
2173 	SLresult (*SetPosition) (
2174 		SLMIDITimeItf self,
2175 		SLuint32 position
2176 	);
2177 	SLresult (*GetPosition) (
2178 		SLMIDITimeItf self,
2179 		SLuint32 *pPosition
2180 	);
2181 	SLresult (*SetLoopPoints) (
2182 		SLMIDITimeItf self,
2183 		SLuint32 startTick,
2184 		SLuint32 numTicks
2185 	);
2186 	SLresult (*GetLoopPoints) (
2187 		SLMIDITimeItf self,
2188 		SLuint32 *pStartTick,
2189 		SLuint32 *pNumTicks
2190 	);
2191 };
2192 
2193 
2194 /*---------------------------------------------------------------------------*/
2195 /* Audio Decoder Capabilities Interface                                      */
2196 /* --------------------------------------------------------------------------*/
2197 
2198 /*Audio Codec related defines*/
2199 
2200 #define SL_RATECONTROLMODE_CONSTANTBITRATE	((SLuint32) 0x00000001)
2201 #define SL_RATECONTROLMODE_VARIABLEBITRATE	((SLuint32) 0x00000002)
2202 
2203 #define SL_AUDIOCODEC_PCM         ((SLuint32) 0x00000001)
2204 #define SL_AUDIOCODEC_MP3         ((SLuint32) 0x00000002)
2205 #define SL_AUDIOCODEC_AMR         ((SLuint32) 0x00000003)
2206 #define SL_AUDIOCODEC_AMRWB       ((SLuint32) 0x00000004)
2207 #define SL_AUDIOCODEC_AMRWBPLUS   ((SLuint32) 0x00000005)
2208 #define SL_AUDIOCODEC_AAC         ((SLuint32) 0x00000006)
2209 #define SL_AUDIOCODEC_WMA         ((SLuint32) 0x00000007)
2210 #define SL_AUDIOCODEC_REAL        ((SLuint32) 0x00000008)
2211 
2212 #define SL_AUDIOPROFILE_PCM                   ((SLuint32) 0x00000001)
2213 
2214 #define SL_AUDIOPROFILE_MPEG1_L3              ((SLuint32) 0x00000001)
2215 #define SL_AUDIOPROFILE_MPEG2_L3              ((SLuint32) 0x00000002)
2216 #define SL_AUDIOPROFILE_MPEG25_L3             ((SLuint32) 0x00000003)
2217 
2218 #define SL_AUDIOCHANMODE_MP3_MONO             ((SLuint32) 0x00000001)
2219 #define SL_AUDIOCHANMODE_MP3_STEREO           ((SLuint32) 0x00000002)
2220 #define SL_AUDIOCHANMODE_MP3_JOINTSTEREO      ((SLuint32) 0x00000003)
2221 #define SL_AUDIOCHANMODE_MP3_DUAL             ((SLuint32) 0x00000004)
2222 
2223 #define SL_AUDIOPROFILE_AMR			((SLuint32) 0x00000001)
2224 
2225 #define SL_AUDIOSTREAMFORMAT_CONFORMANCE	((SLuint32) 0x00000001)
2226 #define SL_AUDIOSTREAMFORMAT_IF1			((SLuint32) 0x00000002)
2227 #define SL_AUDIOSTREAMFORMAT_IF2			((SLuint32) 0x00000003)
2228 #define SL_AUDIOSTREAMFORMAT_FSF			((SLuint32) 0x00000004)
2229 #define SL_AUDIOSTREAMFORMAT_RTPPAYLOAD	((SLuint32) 0x00000005)
2230 #define SL_AUDIOSTREAMFORMAT_ITU			((SLuint32) 0x00000006)
2231 
2232 #define SL_AUDIOPROFILE_AMRWB			((SLuint32) 0x00000001)
2233 
2234 #define SL_AUDIOPROFILE_AMRWBPLUS		((SLuint32) 0x00000001)
2235 
2236 #define SL_AUDIOPROFILE_AAC_AAC			((SLuint32) 0x00000001)
2237 
2238 #define SL_AUDIOMODE_AAC_MAIN			((SLuint32) 0x00000001)
2239 #define SL_AUDIOMODE_AAC_LC			((SLuint32) 0x00000002)
2240 #define SL_AUDIOMODE_AAC_SSR			((SLuint32) 0x00000003)
2241 #define SL_AUDIOMODE_AAC_LTP			((SLuint32) 0x00000004)
2242 #define SL_AUDIOMODE_AAC_HE			((SLuint32) 0x00000005)
2243 #define SL_AUDIOMODE_AAC_SCALABLE		((SLuint32) 0x00000006)
2244 #define SL_AUDIOMODE_AAC_ERLC			((SLuint32) 0x00000007)
2245 #define SL_AUDIOMODE_AAC_LD			((SLuint32) 0x00000008)
2246 #define SL_AUDIOMODE_AAC_HE_PS			((SLuint32) 0x00000009)
2247 #define SL_AUDIOMODE_AAC_HE_MPS			((SLuint32) 0x0000000A)
2248 
2249 #define SL_AUDIOSTREAMFORMAT_MP2ADTS		((SLuint32) 0x00000001)
2250 #define SL_AUDIOSTREAMFORMAT_MP4ADTS		((SLuint32) 0x00000002)
2251 #define SL_AUDIOSTREAMFORMAT_MP4LOAS		((SLuint32) 0x00000003)
2252 #define SL_AUDIOSTREAMFORMAT_MP4LATM		((SLuint32) 0x00000004)
2253 #define SL_AUDIOSTREAMFORMAT_ADIF		((SLuint32) 0x00000005)
2254 #define SL_AUDIOSTREAMFORMAT_MP4FF		((SLuint32) 0x00000006)
2255 #define SL_AUDIOSTREAMFORMAT_RAW			((SLuint32) 0x00000007)
2256 
2257 #define SL_AUDIOPROFILE_WMA7		((SLuint32) 0x00000001)
2258 #define SL_AUDIOPROFILE_WMA8		((SLuint32) 0x00000002)
2259 #define SL_AUDIOPROFILE_WMA9		((SLuint32) 0x00000003)
2260 #define SL_AUDIOPROFILE_WMA10		((SLuint32) 0x00000004)
2261 
2262 #define SL_AUDIOMODE_WMA_LEVEL1		((SLuint32) 0x00000001)
2263 #define SL_AUDIOMODE_WMA_LEVEL2		((SLuint32) 0x00000002)
2264 #define SL_AUDIOMODE_WMA_LEVEL3		((SLuint32) 0x00000003)
2265 #define SL_AUDIOMODE_WMA_LEVEL4		((SLuint32) 0x00000004)
2266 #define SL_AUDIOMODE_WMAPRO_LEVELM0	((SLuint32) 0x00000005)
2267 #define SL_AUDIOMODE_WMAPRO_LEVELM1	((SLuint32) 0x00000006)
2268 #define SL_AUDIOMODE_WMAPRO_LEVELM2	((SLuint32) 0x00000007)
2269 #define SL_AUDIOMODE_WMAPRO_LEVELM3	((SLuint32) 0x00000008)
2270 
2271 #define SL_AUDIOPROFILE_REALAUDIO		((SLuint32) 0x00000001)
2272 
2273 #define SL_AUDIOMODE_REALAUDIO_G2		((SLuint32) 0x00000001)
2274 #define SL_AUDIOMODE_REALAUDIO_8			((SLuint32) 0x00000002)
2275 #define SL_AUDIOMODE_REALAUDIO_10		((SLuint32) 0x00000003)
2276 #define SL_AUDIOMODE_REALAUDIO_SURROUND	((SLuint32) 0x00000004)
2277 
2278 typedef struct SLAudioCodecDescriptor_ {
2279     SLuint32      maxChannels;
2280     SLuint32      minBitsPerSample;
2281     SLuint32      maxBitsPerSample;
2282     SLmilliHertz  minSampleRate;
2283     SLmilliHertz  maxSampleRate;
2284     SLboolean     isFreqRangeContinuous;
2285     SLmilliHertz *pSampleRatesSupported;
2286     SLuint32      numSampleRatesSupported;
2287     SLuint32      minBitRate;
2288     SLuint32      maxBitRate;
2289     SLboolean     isBitrateRangeContinuous;
2290     SLuint32     *pBitratesSupported;
2291     SLuint32      numBitratesSupported;
2292     SLuint32	  profileSetting;
2293     SLuint32      modeSetting;
2294 } SLAudioCodecDescriptor;
2295 
2296 /*Structure used to retrieve the profile and level settings supported by an audio encoder */
2297 
2298 typedef struct SLAudioCodecProfileMode_ {
2299     SLuint32 profileSetting;
2300     SLuint32 modeSetting;
2301 } SLAudioCodecProfileMode;
2302 
2303 extern SL_API const SLInterfaceID SL_IID_AUDIODECODERCAPABILITIES;
2304 
2305 struct SLAudioDecoderCapabilitiesItf_;
2306 typedef const struct SLAudioDecoderCapabilitiesItf_ * const * SLAudioDecoderCapabilitiesItf;
2307 
2308 struct SLAudioDecoderCapabilitiesItf_ {
2309     SLresult (*GetAudioDecoders) (
2310         SLAudioDecoderCapabilitiesItf self,
2311         SLuint32 * pNumDecoders ,
2312         SLuint32 *pDecoderIds
2313     );
2314     SLresult (*GetAudioDecoderCapabilities) (
2315         SLAudioDecoderCapabilitiesItf self,
2316         SLuint32 decoderId,
2317         SLuint32 *pIndex,
2318         SLAudioCodecDescriptor *pDescriptor
2319     );
2320 };
2321 
2322 
2323 
2324 
2325 /*---------------------------------------------------------------------------*/
2326 /* Audio Encoder Capabilities Interface                                      */
2327 /* --------------------------------------------------------------------------*/
2328 
2329 /* Structure used when setting audio encoding parameters */
2330 
2331 typedef struct SLAudioEncoderSettings_ {
2332     SLuint32 encoderId;
2333     SLuint32 channelsIn;
2334     SLuint32 channelsOut;
2335     SLmilliHertz sampleRate;
2336     SLuint32 bitRate;
2337     SLuint32 bitsPerSample;
2338     SLuint32 rateControl;
2339     SLuint32 profileSetting;
2340     SLuint32 levelSetting;
2341     SLuint32 channelMode;
2342     SLuint32 streamFormat;
2343     SLuint32 encodeOptions;
2344     SLuint32 blockAlignment;
2345 } SLAudioEncoderSettings;
2346 
2347 extern SL_API const SLInterfaceID SL_IID_AUDIOENCODERCAPABILITIES;
2348 
2349 struct SLAudioEncoderCapabilitiesItf_;
2350 typedef const struct SLAudioEncoderCapabilitiesItf_ * const * SLAudioEncoderCapabilitiesItf;
2351 
2352 struct SLAudioEncoderCapabilitiesItf_ {
2353     SLresult (*GetAudioEncoders) (
2354         SLAudioEncoderCapabilitiesItf self,
2355         SLuint32 *pNumEncoders ,
2356         SLuint32 *pEncoderIds
2357     );
2358     SLresult (*GetAudioEncoderCapabilities) (
2359         SLAudioEncoderCapabilitiesItf self,
2360         SLuint32 encoderId,
2361         SLuint32 *pIndex,
2362         SLAudioCodecDescriptor * pDescriptor
2363     );
2364 };
2365 
2366 
2367 /*---------------------------------------------------------------------------*/
2368 /* Audio Encoder Interface                                                   */
2369 /* --------------------------------------------------------------------------*/
2370 
2371 
2372 extern SL_API const SLInterfaceID SL_IID_AUDIOENCODER;
2373 
2374 struct SLAudioEncoderItf_;
2375 typedef const struct SLAudioEncoderItf_ * const * SLAudioEncoderItf;
2376 
2377 struct SLAudioEncoderItf_ {
2378     SLresult (*SetEncoderSettings) (
2379         SLAudioEncoderItf		self,
2380         SLAudioEncoderSettings 	*pSettings
2381     );
2382     SLresult (*GetEncoderSettings) (
2383         SLAudioEncoderItf		self,
2384         SLAudioEncoderSettings	*pSettings
2385     );
2386 };
2387 
2388 
2389 /*---------------------------------------------------------------------------*/
2390 /* Bass Boost Interface                                                      */
2391 /* --------------------------------------------------------------------------*/
2392 
2393 
2394 extern SL_API const SLInterfaceID SL_IID_BASSBOOST;
2395 
2396 struct SLBassBoostItf_;
2397 typedef const struct SLBassBoostItf_ * const * SLBassBoostItf;
2398 
2399 struct SLBassBoostItf_ {
2400 	SLresult (*SetEnabled)(
2401 		SLBassBoostItf self,
2402 		SLboolean enabled
2403 	);
2404 	SLresult (*IsEnabled)(
2405 		SLBassBoostItf self,
2406 		SLboolean *pEnabled
2407 	);
2408 	SLresult (*SetStrength)(
2409 		SLBassBoostItf self,
2410 		SLpermille strength
2411 	);
2412 	SLresult (*GetRoundedStrength)(
2413 		SLBassBoostItf self,
2414 		SLpermille *pStrength
2415 	);
2416 	SLresult (*IsStrengthSupported)(
2417 		SLBassBoostItf self,
2418 		SLboolean *pSupported
2419 	);
2420 };
2421 
2422 /*---------------------------------------------------------------------------*/
2423 /* Pitch Interface                                                           */
2424 /* --------------------------------------------------------------------------*/
2425 
2426 
2427 extern SL_API const SLInterfaceID SL_IID_PITCH;
2428 
2429 struct SLPitchItf_;
2430 typedef const struct SLPitchItf_ * const * SLPitchItf;
2431 
2432 struct SLPitchItf_ {
2433 	SLresult (*SetPitch) (
2434 		SLPitchItf self,
2435 		SLpermille pitch
2436 	);
2437 	SLresult (*GetPitch) (
2438 		SLPitchItf self,
2439 		SLpermille *pPitch
2440 	);
2441 	SLresult (*GetPitchCapabilities) (
2442 		SLPitchItf self,
2443 		SLpermille *pMinPitch,
2444 		SLpermille *pMaxPitch
2445 	);
2446 };
2447 
2448 
2449 /*---------------------------------------------------------------------------*/
2450 /* Rate Pitch Interface                                                      */
2451 /* RatePitchItf is an interface for controlling the rate a sound is played   */
2452 /* back. A change in rate will cause a change in pitch.                      */
2453 /* --------------------------------------------------------------------------*/
2454 
2455 
2456 extern SL_API const SLInterfaceID SL_IID_RATEPITCH;
2457 
2458 struct SLRatePitchItf_;
2459 typedef const struct SLRatePitchItf_ * const * SLRatePitchItf;
2460 
2461 struct SLRatePitchItf_ {
2462 	SLresult (*SetRate) (
2463 		SLRatePitchItf self,
2464 		SLpermille rate
2465 	);
2466 	SLresult (*GetRate) (
2467 		SLRatePitchItf self,
2468 		SLpermille *pRate
2469 	);
2470 	SLresult (*GetRatePitchCapabilities) (
2471 		SLRatePitchItf self,
2472 		SLpermille *pMinRate,
2473 		SLpermille *pMaxRate
2474 	);
2475 };
2476 
2477 
2478 /*---------------------------------------------------------------------------*/
2479 /* Virtualizer Interface                                                      */
2480 /* --------------------------------------------------------------------------*/
2481 
2482 
2483 extern SL_API const SLInterfaceID SL_IID_VIRTUALIZER;
2484 
2485 struct SLVirtualizerItf_;
2486 typedef const struct SLVirtualizerItf_ * const * SLVirtualizerItf;
2487 
2488 struct SLVirtualizerItf_ {
2489 	SLresult (*SetEnabled)(
2490 		SLVirtualizerItf self,
2491 		SLboolean enabled
2492 	);
2493 	SLresult (*IsEnabled)(
2494 		SLVirtualizerItf self,
2495 		SLboolean *pEnabled
2496 	);
2497 	SLresult (*SetStrength)(
2498 		SLVirtualizerItf self,
2499 		SLpermille strength
2500 	);
2501 	SLresult (*GetRoundedStrength)(
2502 		SLVirtualizerItf self,
2503 		SLpermille *pStrength
2504 	);
2505 	SLresult (*IsStrengthSupported)(
2506 		SLVirtualizerItf self,
2507 		SLboolean *pSupported
2508 	);
2509 };
2510 
2511 /*---------------------------------------------------------------------------*/
2512 /* Visualization Interface                                                   */
2513 /* --------------------------------------------------------------------------*/
2514 
2515 
2516 extern SL_API const SLInterfaceID SL_IID_VISUALIZATION;
2517 
2518 struct SLVisualizationItf_;
2519 typedef const struct SLVisualizationItf_ * const * SLVisualizationItf;
2520 
2521 typedef void (SLAPIENTRY *slVisualizationCallback) (
2522 	void *pContext,
2523 	const SLuint8 waveform[],
2524 	const SLuint8 fft[],
2525 	SLmilliHertz samplerate
2526 );
2527 
2528 struct SLVisualizationItf_{
2529 	SLresult (*RegisterVisualizationCallback)(
2530 		SLVisualizationItf self,
2531 		slVisualizationCallback callback,
2532 		void *pContext,
2533 		SLmilliHertz rate
2534 	);
2535 	SLresult (*GetMaxRate)(
2536 		SLVisualizationItf self,
2537 		SLmilliHertz* pRate
2538 	);
2539 };
2540 
2541 
2542 /*---------------------------------------------------------------------------*/
2543 /* Engine Interface                                                          */
2544 /* --------------------------------------------------------------------------*/
2545 
2546 
2547 extern SL_API const SLInterfaceID SL_IID_ENGINE;
2548 
2549 struct SLEngineItf_;
2550 typedef const struct SLEngineItf_ * const * SLEngineItf;
2551 
2552 
2553 struct SLEngineItf_ {
2554 
2555 	SLresult (*CreateLEDDevice) (
2556 		SLEngineItf self,
2557 		SLObjectItf * pDevice,
2558 		SLuint32 deviceID,
2559 		SLuint32 numInterfaces,
2560 		const SLInterfaceID * pInterfaceIds,
2561 		const SLboolean * pInterfaceRequired
2562 	);
2563 	SLresult (*CreateVibraDevice) (
2564 		SLEngineItf self,
2565 		SLObjectItf * pDevice,
2566 		SLuint32 deviceID,
2567 		SLuint32 numInterfaces,
2568 		const SLInterfaceID * pInterfaceIds,
2569 		const SLboolean * pInterfaceRequired
2570 	);
2571 	SLresult (*CreateAudioPlayer) (
2572 		SLEngineItf self,
2573 		SLObjectItf * pPlayer,
2574 		SLDataSource *pAudioSrc,
2575 		SLDataSink *pAudioSnk,
2576 		SLuint32 numInterfaces,
2577 		const SLInterfaceID * pInterfaceIds,
2578 		const SLboolean * pInterfaceRequired
2579 	);
2580 	SLresult (*CreateAudioRecorder) (
2581 		SLEngineItf self,
2582 		SLObjectItf * pRecorder,
2583 		SLDataSource *pAudioSrc,
2584 		SLDataSink *pAudioSnk,
2585 		SLuint32 numInterfaces,
2586 		const SLInterfaceID * pInterfaceIds,
2587 		const SLboolean * pInterfaceRequired
2588 	);
2589 	SLresult (*CreateMidiPlayer) (
2590 		SLEngineItf self,
2591 		SLObjectItf * pPlayer,
2592 		SLDataSource *pMIDISrc,
2593 		SLDataSource *pBankSrc,
2594 		SLDataSink *pAudioOutput,
2595 		SLDataSink *pVibra,
2596 		SLDataSink *pLEDArray,
2597 		SLuint32 numInterfaces,
2598 		const SLInterfaceID * pInterfaceIds,
2599 		const SLboolean * pInterfaceRequired
2600 	);
2601 	SLresult (*CreateListener) (
2602 		SLEngineItf self,
2603 		SLObjectItf * pListener,
2604 		SLuint32 numInterfaces,
2605 		const SLInterfaceID * pInterfaceIds,
2606 		const SLboolean * pInterfaceRequired
2607 	);
2608 	SLresult (*Create3DGroup) (
2609 		SLEngineItf self,
2610 		SLObjectItf * pGroup,
2611 		SLuint32 numInterfaces,
2612 		const SLInterfaceID * pInterfaceIds,
2613 		const SLboolean * pInterfaceRequired
2614 	);
2615 	SLresult (*CreateOutputMix) (
2616 		SLEngineItf self,
2617 		SLObjectItf * pMix,
2618 		SLuint32 numInterfaces,
2619 		const SLInterfaceID * pInterfaceIds,
2620 		const SLboolean * pInterfaceRequired
2621 	);
2622 	SLresult (*CreateMetadataExtractor) (
2623 		SLEngineItf self,
2624 		SLObjectItf * pMetadataExtractor,
2625 		SLDataSource * pDataSource,
2626 		SLuint32 numInterfaces,
2627 		const SLInterfaceID * pInterfaceIds,
2628 		const SLboolean * pInterfaceRequired
2629 	);
2630     SLresult (*CreateExtensionObject) (
2631         SLEngineItf self,
2632         SLObjectItf * pObject,
2633         void * pParameters,
2634         SLuint32 objectID,
2635         SLuint32 numInterfaces,
2636         const SLInterfaceID * pInterfaceIds,
2637         const SLboolean * pInterfaceRequired
2638     );
2639 	SLresult (*QueryNumSupportedInterfaces) (
2640 		SLEngineItf self,
2641 		SLuint32 objectID,
2642 		SLuint32 * pNumSupportedInterfaces
2643 	);
2644 	SLresult (*QuerySupportedInterfaces) (
2645 		SLEngineItf self,
2646 		SLuint32 objectID,
2647 		SLuint32 index,
2648 		SLInterfaceID * pInterfaceId
2649 	);
2650     SLresult (*QueryNumSupportedExtensions) (
2651         SLEngineItf self,
2652         SLuint32 * pNumExtensions
2653     );
2654     SLresult (*QuerySupportedExtension) (
2655         SLEngineItf self,
2656         SLuint32 index,
2657         SLchar * pExtensionName,
2658         SLint16 * pNameLength
2659     );
2660     SLresult (*IsExtensionSupported) (
2661         SLEngineItf self,
2662         const SLchar * pExtensionName,
2663         SLboolean * pSupported
2664     );
2665 };
2666 
2667 
2668 /*---------------------------------------------------------------------------*/
2669 /* Engine Capabilities Interface                                             */
2670 /* --------------------------------------------------------------------------*/
2671 
2672 
2673 extern SL_API const SLInterfaceID SL_IID_ENGINECAPABILITIES;
2674 
2675 struct SLEngineCapabilitiesItf_;
2676 typedef const struct SLEngineCapabilitiesItf_ * const * SLEngineCapabilitiesItf;
2677 
2678 struct SLEngineCapabilitiesItf_ {
2679 	SLresult (*QuerySupportedProfiles) (
2680 		SLEngineCapabilitiesItf self,
2681 		SLuint16 *pProfilesSupported
2682 	);
2683 	SLresult (*QueryAvailableVoices) (
2684 		SLEngineCapabilitiesItf self,
2685 		SLuint16 voiceType,
2686 		SLint16 *pNumMaxVoices,
2687 		SLboolean *pIsAbsoluteMax,
2688 		SLint16 *pNumFreeVoices
2689 	);
2690 	SLresult (*QueryNumberOfMIDISynthesizers) (
2691 		SLEngineCapabilitiesItf self,
2692 		SLint16 *pNumMIDIsynthesizers
2693 	);
2694 	SLresult (*QueryAPIVersion) (
2695 		SLEngineCapabilitiesItf self,
2696 		SLint16 *pMajor,
2697 		SLint16 *pMinor,
2698 		SLint16 *pStep
2699 	);
2700 	SLresult (*QueryLEDCapabilities) (
2701 		SLEngineCapabilitiesItf self,
2702         SLuint32 *pIndex,
2703 		SLuint32 *pLEDDeviceID,
2704 		SLLEDDescriptor *pDescriptor
2705 	);
2706 	SLresult (*QueryVibraCapabilities) (
2707 		SLEngineCapabilitiesItf self,
2708         SLuint32 *pIndex,
2709 		SLuint32 *pVibraDeviceID,
2710 		SLVibraDescriptor *pDescriptor
2711 	);
2712 	SLresult (*IsThreadSafe) (
2713 		SLEngineCapabilitiesItf self,
2714 		SLboolean *pIsThreadSafe
2715 	);
2716 };
2717 
2718 /*---------------------------------------------------------------------------*/
2719 /* Thread Sync Interface                                                     */
2720 /* --------------------------------------------------------------------------*/
2721 
2722 
2723 extern SL_API const SLInterfaceID SL_IID_THREADSYNC;
2724 
2725 struct SLThreadSyncItf_;
2726 typedef const struct SLThreadSyncItf_ * const * SLThreadSyncItf;
2727 
2728 
2729 struct SLThreadSyncItf_ {
2730 	SLresult (*EnterCriticalSection) (
2731 		SLThreadSyncItf self
2732 	);
2733 	SLresult (*ExitCriticalSection) (
2734 		SLThreadSyncItf self
2735 	);
2736 };
2737 
2738 
2739 /*****************************************************************************/
2740 /* SL engine constructor                                                     */
2741 /*****************************************************************************/
2742 
2743 #define SL_ENGINEOPTION_THREADSAFE	((SLuint32) 0x00000001)
2744 #define SL_ENGINEOPTION_LOSSOFCONTROL	((SLuint32) 0x00000002)
2745 
2746 typedef struct SLEngineOption_ {
2747 	SLuint32 feature;
2748 	SLuint32 data;
2749 } SLEngineOption;
2750 
2751 
2752 SL_API SLresult SLAPIENTRY slCreateEngine(
2753 	SLObjectItf             *pEngine,
2754 	SLuint32                numOptions,
2755 	const SLEngineOption    *pEngineOptions,
2756 	SLuint32                numInterfaces,
2757 	const SLInterfaceID     *pInterfaceIds,
2758 	const SLboolean         * pInterfaceRequired
2759 ) SL_API_DEPRECATED(30);
2760 
2761 SL_API SLresult SLAPIENTRY slQueryNumSupportedEngineInterfaces(
2762 	SLuint32 * pNumSupportedInterfaces
2763 ) SL_API_DEPRECATED(30);
2764 
2765 SL_API SLresult SLAPIENTRY slQuerySupportedEngineInterfaces(
2766 	SLuint32 index,
2767 	SLInterfaceID * pInterfaceId
2768 ) SL_API_DEPRECATED(30);
2769 
2770 #ifdef __cplusplus
2771 } /* extern "C" */
2772 #endif
2773 
2774 #endif /* OPENSL_ES_H_ */
2775