Home | History | Annotate | Download | only in SLES
      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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 SLAPIENTRY 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 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 
   2761 SLresult SLAPIENTRY slQueryNumSupportedEngineInterfaces(
   2762 	SLuint32 * pNumSupportedInterfaces
   2763 );
   2764 
   2765 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