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
36extern "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 */
66typedef sl_int8_t              SLint8;          /* 8 bit signed integer  */
67typedef sl_uint8_t             SLuint8;         /* 8 bit unsigned integer */
68typedef sl_int16_t             SLint16;         /* 16 bit signed integer */
69typedef sl_uint16_t            SLuint16;        /* 16 bit unsigned integer */
70typedef sl_int32_t             SLint32;           /* 32 bit signed integer */
71typedef sl_uint32_t            SLuint32;          /* 32 bit unsigned integer */
72
73typedef SLuint32                    SLboolean;
74#define SL_BOOLEAN_FALSE            ((SLboolean) 0x00000000)
75#define SL_BOOLEAN_TRUE             ((SLboolean) 0x00000001)
76
77typedef SLuint8						SLchar;			/* UTF-8 is to be used */
78typedef SLint16						SLmillibel;
79typedef SLuint32					SLmillisecond;
80typedef SLuint32					SLmilliHertz;
81typedef SLint32						SLmillimeter;
82typedef SLint32						SLmillidegree;
83typedef SLint16						SLpermille;
84typedef SLuint32					SLmicrosecond;
85typedef 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 */
94typedef 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 */
103struct SLObjectItf_;
104
105typedef 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
240extern 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*/
259typedef 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*/
265typedef 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*/
279typedef 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*/
287typedef 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*/
294typedef 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*/
300typedef 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*/
313typedef 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*/
356typedef 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
366typedef struct SLDataSource_ {
367	void *pLocator;
368	void *pFormat;
369} SLDataSource;
370
371
372typedef struct SLDataSink_ {
373	void *pLocator;
374	void *pFormat;
375} SLDataSink;
376
377
378
379
380
381
382/*---------------------------------------------------------------------------*/
383/* Standard Object Interface                                                 */
384/*---------------------------------------------------------------------------*/
385
386extern SL_API const SLInterfaceID SL_IID_OBJECT;
387
388/** Object callback */
389
390
391typedef 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
401struct 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
480typedef 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
495typedef 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
511extern SL_API const SLInterfaceID SL_IID_AUDIOIODEVICECAPABILITIES;
512
513struct SLAudioIODeviceCapabilitiesItf_;
514typedef const struct SLAudioIODeviceCapabilitiesItf_ * const * SLAudioIODeviceCapabilitiesItf;
515
516
517typedef void (SLAPIENTRY *slAvailableAudioInputsChangedCallback) (
518	SLAudioIODeviceCapabilitiesItf caller,
519	void *pContext,
520	SLuint32 deviceID,
521	SLint32 numInputs,
522	SLboolean isNew
523);
524
525
526typedef void (SLAPIENTRY *slAvailableAudioOutputsChangedCallback) (
527	SLAudioIODeviceCapabilitiesItf caller,
528	void *pContext,
529	SLuint32 deviceID,
530	SLint32 numOutputs,
531	SLboolean isNew
532);
533
534typedef void (SLAPIENTRY *slDefaultDeviceIDMapChangedCallback) (
535	SLAudioIODeviceCapabilitiesItf caller,
536	void *pContext,
537	SLboolean isOutput,
538	SLint32 numDevices
539);
540
541
542struct 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
611typedef struct SLLEDDescriptor_ {
612	SLuint8   ledCount;
613	SLuint8   primaryLED;
614	SLuint32  colorMask;
615} SLLEDDescriptor;
616
617
618/*---------------------------------------------------------------------------*/
619/* LED Array interface                                                       */
620/*---------------------------------------------------------------------------*/
621
622typedef struct SLHSL_ {
623    SLmillidegree  hue;
624    SLpermille     saturation;
625    SLpermille     lightness;
626} SLHSL;
627
628
629extern SL_API const SLInterfaceID SL_IID_LED;
630
631struct SLLEDArrayItf_;
632typedef const struct SLLEDArrayItf_ * const * SLLEDArrayItf;
633
634struct 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
659typedef 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
673extern SL_API const SLInterfaceID SL_IID_VIBRA;
674
675
676struct SLVibraItf_;
677typedef const struct SLVibraItf_ * const * SLVibraItf;
678
679struct 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
752typedef struct SLMetadataInfo_ {
753    SLuint32     size;
754    SLuint32     encoding;
755    SLchar       langCountry[16];
756    SLuint8      data[1];
757} SLMetadataInfo;
758
759extern SL_API const SLInterfaceID SL_IID_METADATAEXTRACTION;
760
761struct SLMetadataExtractionItf_;
762typedef const struct SLMetadataExtractionItf_ * const * SLMetadataExtractionItf;
763
764
765struct 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
822extern SL_API const SLInterfaceID SL_IID_METADATATRAVERSAL;
823
824struct SLMetadataTraversalItf_;
825typedef const struct SLMetadataTraversalItf_ * const * SLMetadataTraversalItf;
826
827struct 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
859extern SL_API const SLInterfaceID SL_IID_DYNAMICSOURCE;
860
861struct SLDynamicSourceItf_;
862typedef const struct SLDynamicSourceItf_ * const * SLDynamicSourceItf;
863
864struct SLDynamicSourceItf_ {
865	SLresult (*SetSource) (
866		SLDynamicSourceItf self,
867		SLDataSource *pDataSource
868	);
869};
870
871/*---------------------------------------------------------------------------*/
872/* Output Mix interface                                                      */
873/*---------------------------------------------------------------------------*/
874
875extern SL_API const SLInterfaceID SL_IID_OUTPUTMIX;
876
877struct SLOutputMixItf_;
878typedef const struct SLOutputMixItf_ * const * SLOutputMixItf;
879
880typedef void (SLAPIENTRY *slMixDeviceChangeCallback) (
881	SLOutputMixItf caller,
882    void *pContext
883);
884
885
886struct 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
924extern SL_API const SLInterfaceID SL_IID_PLAY;
925
926/** Playback interface methods */
927
928struct SLPlayItf_;
929typedef const struct SLPlayItf_ * const * SLPlayItf;
930
931typedef void (SLAPIENTRY *slPlayCallback) (
932	SLPlayItf caller,
933	void *pContext,
934	SLuint32 event
935);
936
937struct 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
1000extern SL_API const SLInterfaceID SL_IID_PREFETCHSTATUS;
1001
1002
1003/** Prefetch status interface methods */
1004
1005struct SLPrefetchStatusItf_;
1006typedef const struct SLPrefetchStatusItf_ * const * SLPrefetchStatusItf;
1007
1008typedef void (SLAPIENTRY *slPrefetchCallback) (
1009	SLPrefetchStatusItf caller,
1010	void *pContext,
1011	SLuint32 event
1012);
1013
1014struct 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
1058extern SL_API const SLInterfaceID SL_IID_PLAYBACKRATE;
1059
1060struct SLPlaybackRateItf_;
1061typedef const struct SLPlaybackRateItf_ * const * SLPlaybackRateItf;
1062
1063struct 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
1102extern SL_API const SLInterfaceID SL_IID_SEEK;
1103
1104struct SLSeekItf_;
1105typedef const struct SLSeekItf_ * const * SLSeekItf;
1106
1107struct 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
1148extern SL_API const SLInterfaceID SL_IID_RECORD;
1149
1150struct SLRecordItf_;
1151typedef const struct SLRecordItf_ * const * SLRecordItf;
1152
1153typedef void (SLAPIENTRY *slRecordCallback) (
1154	SLRecordItf caller,
1155	void *pContext,
1156	SLuint32 event
1157);
1158
1159/** Recording interface methods */
1160struct 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
1217extern SL_API const SLInterfaceID SL_IID_EQUALIZER;
1218
1219struct SLEqualizerItf_;
1220typedef const struct SLEqualizerItf_ * const * SLEqualizerItf;
1221
1222struct 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
1289extern SL_API const SLInterfaceID SL_IID_VOLUME;
1290
1291struct SLVolumeItf_;
1292typedef const struct SLVolumeItf_ * const * SLVolumeItf;
1293
1294struct 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
1338extern SL_API const SLInterfaceID SL_IID_DEVICEVOLUME;
1339
1340struct SLDeviceVolumeItf_;
1341typedef const struct SLDeviceVolumeItf_ * const * SLDeviceVolumeItf;
1342
1343struct 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
1368extern SL_API const SLInterfaceID SL_IID_BUFFERQUEUE;
1369
1370struct SLBufferQueueItf_;
1371typedef const struct SLBufferQueueItf_ * const * SLBufferQueueItf;
1372
1373typedef void (SLAPIENTRY *slBufferQueueCallback)(
1374	SLBufferQueueItf caller,
1375	void *pContext
1376);
1377
1378/** Buffer queue state **/
1379
1380typedef struct SLBufferQueueState_ {
1381	SLuint32	count;
1382	SLuint32	playIndex;
1383} SLBufferQueueState;
1384
1385
1386struct 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
1420extern SL_API const SLInterfaceID SL_IID_PRESETREVERB;
1421
1422struct SLPresetReverbItf_;
1423typedef const struct SLPresetReverbItf_ * const * SLPresetReverbItf;
1424
1425struct 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
1503typedef 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
1519extern SL_API const SLInterfaceID SL_IID_ENVIRONMENTALREVERB;
1520
1521
1522struct SLEnvironmentalReverbItf_;
1523typedef const struct SLEnvironmentalReverbItf_ * const * SLEnvironmentalReverbItf;
1524
1525struct 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
1621extern SL_API const SLInterfaceID SL_IID_EFFECTSEND;
1622
1623struct SLEffectSendItf_;
1624typedef const struct SLEffectSendItf_ * const * SLEffectSendItf;
1625
1626struct 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
1664extern SL_API const SLInterfaceID SL_IID_3DGROUPING;
1665
1666
1667struct SL3DGroupingItf_ ;
1668typedef const struct SL3DGroupingItf_ * const * SL3DGroupingItf;
1669
1670struct 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
1687extern SL_API const SLInterfaceID SL_IID_3DCOMMIT;
1688
1689struct SL3DCommitItf_;
1690typedef const struct SL3DCommitItf_* const * SL3DCommitItf;
1691
1692struct 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
1707typedef struct SLVec3D_ {
1708	SLint32	x;
1709	SLint32	y;
1710	SLint32	z;
1711} SLVec3D;
1712
1713extern SL_API const SLInterfaceID SL_IID_3DLOCATION;
1714
1715struct SL3DLocationItf_;
1716typedef const struct SL3DLocationItf_ * const * SL3DLocationItf;
1717
1718struct 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
1766extern SL_API const SLInterfaceID SL_IID_3DDOPPLER;
1767
1768struct SL3DDopplerItf_;
1769typedef const struct SL3DDopplerItf_ * const * SL3DDopplerItf;
1770
1771struct 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
1804extern SL_API const SLInterfaceID SL_IID_3DSOURCE;
1805
1806struct SL3DSourceItf_;
1807typedef const struct SL3DSourceItf_ * const * SL3DSourceItf;
1808
1809struct 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
1878extern SL_API const SLInterfaceID SL_IID_3DMACROSCOPIC;
1879
1880struct SL3DMacroscopicItf_;
1881typedef const struct SL3DMacroscopicItf_ * const * SL3DMacroscopicItf;
1882
1883struct 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
1924extern SL_API const SLInterfaceID SL_IID_MUTESOLO;
1925
1926struct SLMuteSoloItf_;
1927typedef const struct SLMuteSoloItf_ * const * SLMuteSoloItf;
1928
1929struct 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
1970extern SL_API const SLInterfaceID SL_IID_DYNAMICINTERFACEMANAGEMENT;
1971
1972struct SLDynamicInterfaceManagementItf_;
1973typedef const struct SLDynamicInterfaceManagementItf_ * const * SLDynamicInterfaceManagementItf;
1974
1975typedef void (SLAPIENTRY *slDynamicInterfaceManagementCallback) (
1976	SLDynamicInterfaceManagementItf caller,
1977	void * pContext,
1978	SLuint32 event,
1979	SLresult result,
1980    const SLInterfaceID iid
1981);
1982
1983
1984struct 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
2019extern SL_API const SLInterfaceID SL_IID_MIDIMESSAGE;
2020
2021struct SLMIDIMessageItf_;
2022typedef const struct SLMIDIMessageItf_ * const * SLMIDIMessageItf;
2023
2024typedef 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
2034typedef 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
2044struct 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
2075extern SL_API const SLInterfaceID SL_IID_MIDIMUTESOLO;
2076
2077struct SLMIDIMuteSoloItf_;
2078typedef const struct SLMIDIMuteSoloItf_ * const * SLMIDIMuteSoloItf;
2079
2080struct 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
2133extern SL_API const SLInterfaceID SL_IID_MIDITEMPO;
2134
2135struct SLMIDITempoItf_;
2136typedef const struct SLMIDITempoItf_ * const * SLMIDITempoItf;
2137
2138struct 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
2163extern SL_API const SLInterfaceID SL_IID_MIDITIME;
2164
2165struct SLMIDITimeItf_;
2166typedef const struct SLMIDITimeItf_ * const * SLMIDITimeItf;
2167
2168struct 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
2278typedef 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
2298typedef struct SLAudioCodecProfileMode_ {
2299    SLuint32 profileSetting;
2300    SLuint32 modeSetting;
2301} SLAudioCodecProfileMode;
2302
2303extern SL_API const SLInterfaceID SL_IID_AUDIODECODERCAPABILITIES;
2304
2305struct SLAudioDecoderCapabilitiesItf_;
2306typedef const struct SLAudioDecoderCapabilitiesItf_ * const * SLAudioDecoderCapabilitiesItf;
2307
2308struct 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
2331typedef 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
2347extern SL_API const SLInterfaceID SL_IID_AUDIOENCODERCAPABILITIES;
2348
2349struct SLAudioEncoderCapabilitiesItf_;
2350typedef const struct SLAudioEncoderCapabilitiesItf_ * const * SLAudioEncoderCapabilitiesItf;
2351
2352struct 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
2372extern SL_API const SLInterfaceID SL_IID_AUDIOENCODER;
2373
2374struct SLAudioEncoderItf_;
2375typedef const struct SLAudioEncoderItf_ * const * SLAudioEncoderItf;
2376
2377struct 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
2394extern SL_API const SLInterfaceID SL_IID_BASSBOOST;
2395
2396struct SLBassBoostItf_;
2397typedef const struct SLBassBoostItf_ * const * SLBassBoostItf;
2398
2399struct 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
2427extern SL_API const SLInterfaceID SL_IID_PITCH;
2428
2429struct SLPitchItf_;
2430typedef const struct SLPitchItf_ * const * SLPitchItf;
2431
2432struct 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
2456extern SL_API const SLInterfaceID SL_IID_RATEPITCH;
2457
2458struct SLRatePitchItf_;
2459typedef const struct SLRatePitchItf_ * const * SLRatePitchItf;
2460
2461struct 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
2483extern SL_API const SLInterfaceID SL_IID_VIRTUALIZER;
2484
2485struct SLVirtualizerItf_;
2486typedef const struct SLVirtualizerItf_ * const * SLVirtualizerItf;
2487
2488struct 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
2516extern SL_API const SLInterfaceID SL_IID_VISUALIZATION;
2517
2518struct SLVisualizationItf_;
2519typedef const struct SLVisualizationItf_ * const * SLVisualizationItf;
2520
2521typedef void (SLAPIENTRY *slVisualizationCallback) (
2522	void *pContext,
2523	const SLuint8 waveform[],
2524	const SLuint8 fft[],
2525	SLmilliHertz samplerate
2526);
2527
2528struct 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
2547extern SL_API const SLInterfaceID SL_IID_ENGINE;
2548
2549struct SLEngineItf_;
2550typedef const struct SLEngineItf_ * const * SLEngineItf;
2551
2552
2553struct 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
2673extern SL_API const SLInterfaceID SL_IID_ENGINECAPABILITIES;
2674
2675struct SLEngineCapabilitiesItf_;
2676typedef const struct SLEngineCapabilitiesItf_ * const * SLEngineCapabilitiesItf;
2677
2678struct 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
2723extern SL_API const SLInterfaceID SL_IID_THREADSYNC;
2724
2725struct SLThreadSyncItf_;
2726typedef const struct SLThreadSyncItf_ * const * SLThreadSyncItf;
2727
2728
2729struct 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
2746typedef struct SLEngineOption_ {
2747	SLuint32 feature;
2748	SLuint32 data;
2749} SLEngineOption;
2750
2751
2752SL_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);
2760
2761SL_API SLresult SLAPIENTRY slQueryNumSupportedEngineInterfaces(
2762	SLuint32 * pNumSupportedInterfaces
2763);
2764
2765SL_API SLresult SLAPIENTRY slQuerySupportedEngineInterfaces(
2766	SLuint32 index,
2767	SLInterfaceID * pInterfaceId
2768);
2769
2770#ifdef __cplusplus
2771} /* extern "C" */
2772#endif
2773
2774#endif /* OPENSL_ES_H_ */
2775