include/sapi.idl

   1 /*
   2  * Speech API (SAPI) IDL file.
   3  *
   4  * Copyright (C) 2017 Huw Davies
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 import "oaidl.idl";
  22 import "ocidl.idl";
  23
  24 #ifndef __WIDL__
  25 #define threading(model)
  26 #define progid(str)
  27 #define vi_progid(str)
  28 #endif
  29
  30 cpp_quote("#if 0")
  31 typedef [restricted, hidden] struct WAVEFORMATEX
  32 {
  33     WORD  wFormatTag;
  34     WORD  nChannels;
  35     DWORD nSamplesPerSec;
  36     DWORD nAvgBytesPerSec;
  37     WORD  nBlockAlign;
  38     WORD  wBitsPerSample;
  39     WORD  cbSize;
  40 } WAVEFORMATEX;
  41 cpp_quote("#else")
  42 cpp_quote("#include <mmsystem.h>")
  43 cpp_quote("#endif")
  44
  45 cpp_quote("#if defined(__cplusplus)")
  46 cpp_quote("interface ISpNotifyCallback")
  47 cpp_quote("{")
  48 cpp_quote("virtual HRESULT STDMETHODCALLTYPE NotifyCallback(WPARAM wParam, LPARAM lParam) = 0;")
  49 cpp_quote("};")
  50 cpp_quote("#else")
  51 typedef void * ISpNotifyCallback;
  52 cpp_quote("#endif")
  53
  54 cpp_quote("#if 0")
  55 typedef void * SPNOTIFYCALLBACK;
  56 typedef void * SPSTATEHANDLE;
  57 cpp_quote("#endif")
  58
  59 typedef [restricted, hidden] struct SPEVENT
  60 {
  61     WORD      eEventId;
  62     WORD      elParamType;
  63     ULONG     ulStreamNum;
  64     ULONGLONG ullAudioStreamOffset;
  65     WPARAM    wParam;
  66     LPARAM    lParam;
  67 } SPEVENT;
  68
  69 cpp_quote("typedef void __stdcall SPNOTIFYCALLBACK(WPARAM wParam, LPARAM lParam);")
  70 cpp_quote("DECLARE_HANDLE(SPSTATEHANDLE);")
  71
  72 const ULONG SP_MAX_LANGIDS = 20;
  73
  74 typedef [restricted, hidden] struct SPEVENTSOURCEINFO
  75 {
  76     ULONGLONG   ullEventInterest;
  77     ULONGLONG   ullQueuedInterest;
  78     ULONG       ulCount;
  79 } SPEVENTSOURCEINFO;
  80
  81 typedef [hidden] enum SPGRAMMARWORDTYPE
  82 {
  83     SPWT_DISPLAY,
  84     SPWT_LEXICAL,
  85     SPWT_PRONUNCIATION,
  86     SPWT_LEXICAL_NO_SPECIAL_CHARS
  87 } SPGRAMMARWORDTYPE;
  88
  89 typedef [hidden] struct tagSPPROPERTYINFO
  90 {
  91     const WCHAR *pszName;
  92     ULONG        ulId;
  93     const WCHAR *pszValue;
  94     VARIANT      vValue;
  95 } SPPROPERTYINFO;
  96
  97 typedef [hidden] enum SPDATAKEYLOCATION
  98 {
  99     SPDKL_DefaultLocation = 0,
 100     SPDKL_CurrentUser     = 1,
 101     SPDKL_LocalMachine    = 2,
 102     SPDKL_CurrentConfig   = 5
 103 } SPDATAKEYLOCATION;
 104
 105 typedef [hidden] enum SPLOADOPTIONS
 106 {
 107     SPLO_STATIC,
 108     SPLO_DYNAMIC
 109 } SPLOADOPTIONS;
 110
 111 typedef [hidden] enum SPRULESTATE
 112 {
 113     SPRS_INACTIVE               = 0,
 114     SPRS_ACTIVE                 = 1,
 115     SPRS_ACTIVE_WITH_AUTO_PAUSE = 3,
 116     SPRS_ACTIVE_USER_DELIMITED  = 4
 117 } SPRULESTATE;
 118
 119 typedef [hidden] enum SPGRAMMARSTATE
 120 {
 121     SPGS_DISABLED  = 0,
 122     SPGS_ENABLED   = 1,
 123     SPGS_EXCLUSIVE = 3
 124 } SPGRAMMARSTATE;
 125
 126 typedef [hidden] struct SPBINARYGRAMMAR
 127 {
 128     ULONG ulTotalSerializedSize;
 129 } SPBINARYGRAMMAR;
 130
 131 typedef [hidden] struct tagSPTEXTSELECTIONINFO
 132 {
 133     ULONG ulStartActiveOffset;
 134     ULONG cchActiveChars;
 135     ULONG ulStartSelection;
 136     ULONG cchSelection;
 137 } SPTEXTSELECTIONINFO;
 138
 139 typedef [hidden] enum SPWORDPRONOUNCEABLE
 140 {
 141     SPWP_UNKNOWN_WORD_UNPRONOUNCEABLE,
 142     SPWP_UNKNOWN_WORD_PRONOUNCEABLE,
 143     SPWP_KNOWN_WORD_PRONOUNCEABLE
 144 } SPWORDPRONOUNCEABLE;
 145
 146 typedef [hidden] enum SPINTERFERENCE
 147 {
 148     SPINTERFERENCE_NONE,
 149     SPINTERFERENCE_NOISE,
 150     SPINTERFERENCE_NOSIGNAL,
 151     SPINTERFERENCE_TOOLOUD,
 152     SPINTERFERENCE_TOOQUIET,
 153     SPINTERFERENCE_TOOFAST,
 154     SPINTERFERENCE_TOOSLOW
 155 } SPINTERFERENCE;
 156
 157 typedef [hidden] enum SPVISEMES
 158 {
 159     SP_VISEME_0 = 0,
 160     SP_VISEME_1,
 161     SP_VISEME_2,
 162     SP_VISEME_3,
 163     SP_VISEME_4,
 164     SP_VISEME_5,
 165     SP_VISEME_6,
 166     SP_VISEME_7,
 167     SP_VISEME_8,
 168     SP_VISEME_9,
 169     SP_VISEME_10,
 170     SP_VISEME_11,
 171     SP_VISEME_12,
 172     SP_VISEME_13,
 173     SP_VISEME_14,
 174     SP_VISEME_15,
 175     SP_VISEME_16,
 176     SP_VISEME_17,
 177     SP_VISEME_18,
 178     SP_VISEME_19,
 179     SP_VISEME_20,
 180     SP_VISEME_21,
 181 } SPVISEMES;
 182
 183 typedef [hidden] enum SPEVENTENUM
 184 {
 185     SPEI_UNDEFINED           = 0,
 186     SPEI_START_INPUT_STREAM  = 1,
 187     SPEI_END_INPUT_STREAM    = 2,
 188     SPEI_VOICE_CHANGE        = 3,
 189     SPEI_TTS_BOOKMARK        = 4,
 190     SPEI_WORD_BOUNDARY       = 5,
 191     SPEI_PHONEME             = 6,
 192     SPEI_SENTENCE_BOUNDARY   = 7,
 193     SPEI_VISEME              = 8,
 194     SPEI_TTS_AUDIO_LEVEL     = 9,
 195     SPEI_TTS_PRIVATE         = 15,
 196
 197     SPEI_MIN_TTS             = 1,
 198     SPEI_MAX_TTS             = 15,
 199
 200     SPEI_END_SR_STREAM          = 34,
 201     SPEI_SOUND_START            = 35,
 202     SPEI_SOUND_END              = 36,
 203     SPEI_PHRASE_START           = 37,
 204     SPEI_RECOGNITION            = 38,
 205     SPEI_HYPOTHESIS             = 39,
 206     SPEI_SR_BOOKMARK            = 40,
 207     SPEI_PROPERTY_NUM_CHANGE    = 41,
 208     SPEI_PROPERTY_STRING_CHANGE = 42,
 209     SPEI_FALSE_RECOGNITION      = 43,
 210     SPEI_INTERFERENCE           = 44,
 211     SPEI_REQUEST_UI             = 45,
 212     SPEI_RECO_STATE_CHANGE      = 46,
 213     SPEI_ADAPTATION             = 47,
 214     SPEI_START_SR_STREAM        = 48,
 215     SPEI_RECO_OTHER_CONTEXT     = 49,
 216     SPEI_SR_AUDIO_LEVEL         = 50,
 217     SPEI_SR_RETAINEDAUDIO       = 51,
 218     SPEI_SR_PRIVATE             = 52,
 219     SPEI_ACTIVE_CATEGORY_CHANGED = 53,
 220
 221     SPEI_MIN_SR              = 34,
 222     SPEI_MAX_SR              = 55,
 223
 224     SPEI_RESERVED1           = 30,
 225     SPEI_RESERVED2           = 33,
 226     SPEI_RESERVED3           = 63
 227 } SPEVENTENUM;
 228
 229 typedef [hidden] enum SPCONTEXTSTATE
 230 {
 231     SPCS_DISABLED = 0,
 232     SPCS_ENABLED  = 1,
 233 } SPCONTEXTSTATE;
 234
 235 typedef [hidden] enum SPVPRIORITY
 236 {
 237     SPVPRI_NORMAL = 0,
 238     SPVPRI_ALERT  = 1,
 239     SPVPRI_OVER   = 2
 240 } SPVPRIORITY;
 241
 242 typedef [hidden] enum SPRECOSTATE
 243 {
 244     SPRST_INACTIVE,
 245     SPRST_ACTIVE,
 246     SPRST_ACTIVE_ALWAYS,
 247     SPRST_INACTIVE_WITH_PURGE,
 248     SPRST_NUM_STATES
 249 } SPRECOSTATE;
 250
 251 typedef [hidden] enum SPWAVEFORMATTYPE
 252 {
 253     SPWF_INPUT,
 254     SPWF_SRENGINE
 255 } SPSTREAMFORMATTYPE;
 256
 257 typedef [restricted, hidden] struct SPRECOCONTEXTSTATUS
 258 {
 259     SPINTERFERENCE  eInterference;
 260     WCHAR           szRequestTypeOfUI[255];
 261     DWORD           dwReserved1;
 262     DWORD           dwReserved2;
 263 } SPRECOCONTEXTSTATUS;
 264
 265 typedef [hidden] enum SPAUDIOOPTIONS
 266 {
 267     SPAO_NONE,
 268     SPAO_RETAIN_AUDIO
 269 } SPAUDIOOPTIONS;
 270
 271 typedef [hidden] struct SPSERIALIZEDRESULT
 272 {
 273     ULONG ulSerializedSize;
 274 } SPSERIALIZEDRESULT;
 275
 276 typedef [hidden] enum SPDISPLYATTRIBUTES
 277 {
 278     SPAF_ONE_TRAILING_SPACE     = 0x02,
 279     SPAF_TWO_TRAILING_SPACES    = 0x04,
 280     SPAF_CONSUME_LEADING_SPACES = 0x08,
 281     SPAF_ALL                    = 0x0f
 282 } SPDISPLAYATTRIBUTES;
 283
 284 typedef [hidden] enum SPBOOKMARKOPTIONS
 285 {
 286     SPBO_NONE,
 287     SPBO_PAUSE
 288 } SPBOOKMARKOPTIONS;
 289
 290 typedef [hidden] enum _SPAUDIOSTATE
 291 {
 292     SPAS_CLOSED,
 293     SPAS_STOP,
 294     SPAS_PAUSE,
 295     SPAS_RUN
 296 } SPAUDIOSTATE;
 297
 298 typedef [hidden] enum SPRUNSTATE
 299 {
 300     SPRS_DONE        = (1L << 0),
 301     SPRS_IS_SPEAKING = (1L << 1)
 302 } SPRUNSTATE;
 303
 304 typedef [hidden] enum SPEAKFLAGS
 305 {
 306     SPF_DEFAULT            = 0,
 307     SPF_ASYNC              = (1L << 0),
 308     SPF_PURGEBEFORESPEAK   = (1L << 1),
 309     SPF_IS_FILENAME        = (1L << 2),
 310     SPF_IS_XML             = (1L << 3),
 311     SPF_IS_NOT_XML         = (1L << 4),
 312     SPF_PERSIST_XML        = (1L << 5),
 313     SPF_NLP_SPEAK_PUNC     = (1L << 6),
 314     SPF_PARSE_SAPI         = (1L << 7),
 315     SPF_PARSE_SSML         = (1L << 8),
 316     SPF_PARSE_AUTODETECT   = 0,
 317     SPF_NLP_MASK           = (SPF_NLP_SPEAK_PUNC),
 318     SPF_PARSE_MASK         = (SPF_PARSE_SAPI|SPF_PARSE_SSML),
 319     SPF_VOICE_MASK         = (SPF_ASYNC|SPF_PURGEBEFORESPEAK|SPF_IS_FILENAME|SPF_IS_XML|SPF_IS_NOT_XML|SPF_NLP_MASK|SPF_PERSIST_XML|SPF_PARSE_MASK),
 320     SPF_UNUSED_FLAGS       = ~(SPF_VOICE_MASK)
 321 } SPEAKFLAGS;
 322
 323 typedef [hidden] enum SPCFGRULEATTRIBUTES
 324 {
 325     SPRAF_TopLevel      = (1 << 0),
 326     SPRAF_Active        = (1 << 1),
 327     SPRAF_Export        = (1 << 2),
 328     SPRAF_Import        = (1 << 3),
 329     SPRAF_Interpreter   = (1 << 4),
 330     SPRAF_Dynamic       = (1 << 5),
 331     SPRAF_Root          = (1 << 6),
 332     SPRAF_AutoPause     = (1 << 16),
 333     SPRAF_UserDelimited = (1 << 17)
 334 } SPCFGRULEATTRIBUTES;
 335
 336 typedef [hidden] enum SPPHRASERNG
 337 {
 338     SPPR_ALL_ELEMENTS = -1
 339 } SPPHRASERNG;
 340
 341 typedef [hidden] enum SPVALUETYPE
 342 {
 343     SPDF_PROPERTY      = 0x00000001,
 344     SPDF_REPLACEMENT   = 0x00000002,
 345     SPDF_RULE          = 0x00000004,
 346     SPDF_DISPLAYTEXT   = 0x00000008,
 347     SPDF_LEXICALFORM   = 0x00000010,
 348     SPDF_PRONUNCIATION = 0x00000020,
 349     SPDF_AUDIO         = 0x00000040,
 350     SPDF_ALTERNATES    = 0x00000080,
 351     SPDF_ALL           = 0x000000ff
 352 } SPVALUETYPE;
 353
 354 typedef [hidden] enum SPSTREAMFORMAT
 355 {
 356     SPSF_Default = -1,
 357     SPSF_NoAssignedFormat = 0,
 358     SPSF_Text,
 359     SPSF_NonStandardFormat,
 360     SPSF_ExtendedAudioFormat,
 361     SPSF_8kHz8BitMono,
 362     SPSF_8kHz8BitStereo,
 363     SPSF_8kHz16BitMono,
 364     SPSF_8kHz16BitStereo,
 365     SPSF_11kHz8BitMono,
 366     SPSF_11kHz8BitStereo,
 367     SPSF_11kHz16BitMono,
 368     SPSF_11kHz16BitStereo,
 369     SPSF_12kHz8BitMono,
 370     SPSF_12kHz8BitStereo,
 371     SPSF_12kHz16BitMono,
 372     SPSF_12kHz16BitStereo,
 373     SPSF_16kHz8BitMono,
 374     SPSF_16kHz8BitStereo,
 375     SPSF_16kHz16BitMono,
 376     SPSF_16kHz16BitStereo,
 377     SPSF_22kHz8BitMono,
 378     SPSF_22kHz8BitStereo,
 379     SPSF_22kHz16BitMono,
 380     SPSF_22kHz16BitStereo,
 381     SPSF_24kHz8BitMono,
 382     SPSF_24kHz8BitStereo,
 383     SPSF_24kHz16BitMono,
 384     SPSF_24kHz16BitStereo,
 385     SPSF_32kHz8BitMono,
 386     SPSF_32kHz8BitStereo,
 387     SPSF_32kHz16BitMono,
 388     SPSF_32kHz16BitStereo,
 389     SPSF_44kHz8BitMono,
 390     SPSF_44kHz8BitStereo,
 391     SPSF_44kHz16BitMono,
 392     SPSF_44kHz16BitStereo,
 393     SPSF_48kHz8BitMono,
 394     SPSF_48kHz8BitStereo,
 395     SPSF_48kHz16BitMono,
 396     SPSF_48kHz16BitStereo,
 397     SPSF_TrueSpeech_8kHz1BitMono,
 398     SPSF_CCITT_ALaw_8kHzMono,
 399     SPSF_CCITT_ALaw_8kHzStereo,
 400     SPSF_CCITT_ALaw_11kHzMono,
 401     SPSF_CCITT_ALaw_11kHzStereo,
 402     SPSF_CCITT_ALaw_22kHzMono,
 403     SPSF_CCITT_ALaw_22kHzStereo,
 404     SPSF_CCITT_ALaw_44kHzMono,
 405     SPSF_CCITT_ALaw_44kHzStereo,
 406     SPSF_CCITT_uLaw_8kHzMono,
 407     SPSF_CCITT_uLaw_8kHzStereo,
 408     SPSF_CCITT_uLaw_11kHzMono,
 409     SPSF_CCITT_uLaw_11kHzStereo,
 410     SPSF_CCITT_uLaw_22kHzMono,
 411     SPSF_CCITT_uLaw_22kHzStereo,
 412     SPSF_CCITT_uLaw_44kHzMono,
 413     SPSF_CCITT_uLaw_44kHzStereo,
 414     SPSF_ADPCM_8kHzMono,
 415     SPSF_ADPCM_8kHzStereo,
 416     SPSF_ADPCM_11kHzMono,
 417     SPSF_ADPCM_11kHzStereo,
 418     SPSF_ADPCM_22kHzMono,
 419     SPSF_ADPCM_22kHzStereo,
 420     SPSF_ADPCM_44kHzMono,
 421     SPSF_ADPCM_44kHzStereo,
 422     SPSF_GSM610_8kHzMono,
 423     SPSF_GSM610_11kHzMono,
 424     SPSF_GSM610_22kHzMono,
 425     SPSF_GSM610_44kHzMono,
 426     SPSF_NUM_FORMATS
 427 } SPSTREAMFORMAT;
 428
 429 typedef unsigned short SPPHONEID;
 430
 431 typedef [restricted, hidden] struct SPPHRASEELEMENT
 432 {
 433     ULONG           ulAudioTimeOffset;
 434     ULONG           ulAudioSizeTime;
 435     ULONG           ulAudioStreamOffset;
 436     ULONG           ulAudioSizeBytes;
 437     ULONG           ulRetainedStreamOffset;
 438     ULONG           ulRetainedSizeBytes;
 439     const WCHAR     *pszDisplayText;
 440     const WCHAR     *pszLexicalForm;
 441     const SPPHONEID *pszPronunciation;
 442     BYTE            bDisplayAttributes;
 443     signed char     RequiredConfidence;
 444     signed char     ActualConfidence;
 445     BYTE            Reserved;
 446     float           SREngineConfidence;
 447 } SPPHRASEELEMENT;
 448
 449 typedef [restricted, hidden] struct SPVOICESTATUS
 450 {
 451     ULONG     ulCurrentStream;
 452     ULONG     ulLastStreamQueued;
 453     HRESULT   hrLastResult;
 454     DWORD     dwRunningState;
 455     ULONG     ulInputWordPos;
 456     ULONG     ulInputWordLen;
 457     ULONG     ulInputSentPos;
 458     ULONG     ulInputSentLen;
 459     LONG      lBookmarkId;
 460     SPPHONEID PhonemeId;
 461     SPVISEMES VisemeId;
 462     DWORD     dwReserved1;
 463     DWORD     dwReserved2;
 464 } SPVOICESTATUS;
 465
 466 typedef [restricted, hidden] struct SPAUDIOSTATUS
 467 {
 468     long         cbFreeBuffSpace;
 469     ULONG        cbNonBlockingIO;
 470     SPAUDIOSTATE State;
 471     ULONGLONG    CurSeekPos;
 472     ULONGLONG    CurDevicePos;
 473     DWORD        dwAudioLevel;
 474     DWORD        dwReserved2;
 475 } SPAUDIOSTATUS;
 476
 477 typedef [restricted, hidden] struct SPRECOGNIZERSTATUS
 478 {
 479     SPAUDIOSTATUS AudioStatus;
 480     ULONGLONG     ullRecognitionStreamPos;
 481     ULONG         ulStreamNumber;
 482     ULONG         ulNumActive;
 483     CLSID         clsidEngine;
 484     ULONG         cLangIDs;
 485     LANGID        aLangID[SP_MAX_LANGIDS];
 486     ULONGLONG     ullRecognitionStreamTime;
 487 } SPRECOGNIZERSTATUS;
 488
 489 typedef [restricted, hidden] struct SPPHRASERULE SPPHRASERULE;
 490
 491 struct SPPHRASERULE
 492 {
 493     LPCWSTR                 pszName;
 494     ULONG                   ulId;
 495     ULONG                   ulFirstElement;
 496     ULONG                   ulCountOfElements;
 497     const SPPHRASERULE*     pNextSibling;
 498     const SPPHRASERULE*     pFirstChild;
 499     float                   SREngineConfidence;
 500     signed char             Confidence;
 501 };
 502
 503 typedef [restricted, hidden] struct SPPHRASEPROPERTY SPPHRASEPROPERTY;
 504
 505 struct SPPHRASEPROPERTY
 506 {
 507     const WCHAR            *pszName;
 508     ULONG                   ulId;
 509     const WCHAR            *pszValue;
 510     VARIANT                 vValue;
 511     ULONG                   ulFirstElement;
 512     ULONG                   ulCountOfElements;
 513     const SPPHRASEPROPERTY *pNextSibling;
 514     const SPPHRASEPROPERTY *pFirstChild;
 515     float                   SREngineConfidence;
 516     signed char             Confidence;
 517 };
 518
 519 typedef [restricted, hidden] struct SPPHRASEREPLACEMENT
 520 {
 521     BYTE         bDisplayAttributes;
 522     const WCHAR *pszReplacementText;
 523     ULONG        ulFirstElement;
 524     ULONG        ulCountOfElements;
 525 } SPPHRASEREPLACEMENT;
 526
 527 typedef [restricted, hidden] struct SPPHRASE
 528 {
 529     ULONG                   cbSize;
 530     LANGID                  LangID;
 531     WORD                    wReserved;
 532     ULONGLONG               ullGrammarID;
 533     ULONGLONG               ftStartTime;
 534     ULONGLONG               ullAudioStreamPosition;
 535     ULONG                   ulAudioSizeBytes;
 536     ULONG                   ulRetainedSizeBytes;
 537     ULONG                   ulAudioSizeTime;
 538     SPPHRASERULE            Rule;
 539     const SPPHRASEPROPERTY *pProperties;
 540     const SPPHRASEELEMENT  *pElements;
 541     ULONG                   cReplacements;
 542     const SPPHRASEREPLACEMENT *pReplacements;
 543     GUID                    SREngineID;
 544     ULONG                   ulSREnginePrivateDataSize;
 545     const BYTE             *pSREnginePrivateData;
 546 } SPPHRASE;
 547
 548 typedef [restricted, hidden] struct SPSERIALIZEDPHRASE
 549 {
 550     ULONG ulSerializedSize;
 551 } SPSERIALIZEDPHRASE;
 552
 553 typedef [restricted, hidden] struct SPRECORESULTTIMES
 554 {
 555     FILETIME  ftStreamTime;
 556     ULONGLONG ullLength;
 557     DWORD     dwTickCount;
 558     ULONGLONG ullStart;
 559 } SPRECORESULTTIMES;
 560
 561 typedef [hidden] enum SPFILEMODE
 562 {
 563     SPFM_OPEN_READONLY,
 564     SPFM_OPEN_READWRITE,
 565     SPFM_CREATE,
 566     SPFM_CREATE_ALWAYS,
 567     SPFM_NUM_MODES
 568 } SPFILEMODE;
 569
 570 typedef [restricted, hidden] struct SPAUDIOBUFFERINFO
 571 {
 572     ULONG ulMsMinNotification;
 573     ULONG ulMsBufferSize;
 574     ULONG ulMsEventBias;
 575 } SPAUDIOBUFFERINFO;
 576
 577 typedef [hidden] enum SPPARTOFSPEECH
 578 {
 579     SPPS_NotOverriden  = -1,
 580     SPPS_Unknown       = 0,
 581     SPPS_Noun          = 0x1000,
 582     SPPS_Verb          = 0x2000,
 583     SPPS_Modifier      = 0x3000,
 584     SPPS_Function      = 0x4000,
 585     SPPS_Interjection  = 0x5000,
 586     SPPS_Noncontent    = 0x6000,
 587     SPPS_LMA           = 0x7000,
 588     SPPS_SuppressWord  = 0xF000
 589 } SPPARTOFSPEECH;
 590
 591 typedef [restricted, hidden] struct SPVPITCH
 592 {
 593     long MiddleAdj;
 594     long RangeAdj;
 595 } SPVPITCH;
 596
 597 typedef [hidden] enum SPVACTIONS
 598 {
 599     SPVA_Speak = 0,
 600     SPVA_Silence,
 601     SPVA_Pronounce,
 602     SPVA_Bookmark,
 603     SPVA_SpellOut,
 604     SPVA_Section,
 605     SPVA_ParseUnknownTag
 606 } SPVACTIONS;
 607
 608 typedef [restricted, hidden] struct SPVCONTEXT
 609 {
 610     LPCWSTR pCategory;
 611     LPCWSTR pBefore;
 612     LPCWSTR pAfter;
 613 } SPVCONTEXT;
 614
 615 typedef [restricted, hidden] struct SPVSTATE
 616 {
 617     SPVACTIONS      eAction;
 618     LANGID          LangID;
 619     WORD            wReserved;
 620     long            EmphAdj;
 621     long            RateAdj;
 622     ULONG           Volume;
 623     SPVPITCH        PitchAdj;
 624     ULONG           SilenceMSecs;
 625     SPPHONEID      *pPhoneIds;
 626     SPPARTOFSPEECH  ePartOfSpeech;
 627     SPVCONTEXT      Context;
 628 } SPVSTATE;
 629
 630 cpp_quote("#if defined(__GNUC__)")
 631
 632 cpp_quote("#define SPCAT_AUDIOOUT (const WCHAR []){ 'H','K','E','Y','_','L','O','C','A','L','_','M','A','C','H','I','N','E','\\\\','S','O','F','T','W','A','R','E','\\\\','M','i','c','r','o','s','o','f','t','\\\\','S','p','e','e','c','h','\\\\','A','u','d','i','o','O','u','t','p','u','t',0 }")
 633 cpp_quote("#define SPCAT_AUDIOIN (const WCHAR []){ 'H','K','E','Y','_','L','O','C','A','L','_','M','A','C','H','I','N','E','\\\\','S','O','F','T','W','A','R','E','\\\\','M','i','c','r','o','s','o','f','t','\\\\','S','p','e','e','c','h','\\\\','A','u','d','i','o','I','n','p','u','t',0 }")
 634 cpp_quote("#define SPCAT_VOICES (const WCHAR []){ 'H','K','E','Y','_','L','O','C','A','L','_','M','A','C','H','I','N','E','\\\\','S','O','F','T','W','A','R','E','\\\\','M','i','c','r','o','s','o','f','t','\\\\','S','p','e','e','c','h','\\\\','V','o','i','c','e','s',0 }")
 635
 636 cpp_quote("#elif defined(_MSC_VER)")
 637
 638 cpp_quote("#define SPCAT_AUDIOOUT L\"HKEY_LOCAL_MACHINE\\\\SOFTWARE\\\\Microsoft\\\\Speech\\\\AudioOutput\"")
 639 cpp_quote("#define SPCAT_AUDIOIN L\"HKEY_LOCAL_MACHINE\\\\SOFTWARE\\\\Microsoft\\\\Speech\\\\AudioInput\"")
 640 cpp_quote("#define SPCAT_VOICES L\"HKEY_LOCAL_MACHINE\\\\SOFTWARE\\\\Microsoft\\\\Speech\\\\Voices\"")
 641
 642 cpp_quote("#else")
 643
 644 cpp_quote("static const WCHAR SPCAT_AUDIOOUT[] = {'H','K','E','Y','_','L','O','C','A','L','_','M','A','C','H','I','N','E','\\\\','S','O','F','T','W','A','R','E','\\\\','M','i','c','r','o','s','o','f','t','\\\\','S','p','e','e','c','h','\\\\','A','u','d','i','o','O','u','t','p','u','t',0};")
 645 cpp_quote("static const WCHAR SPCAT_AUDIOIN[] = {'H','K','E','Y','_','L','O','C','A','L','_','M','A','C','H','I','N','E','\\\\','S','O','F','T','W','A','R','E','\\\\','M','i','c','r','o','s','o','f','t','\\\\','S','p','e','e','c','h','\\\\','A','u','d','i','o','I','n','p','u','t',0};")
 646 cpp_quote("static const WCHAR SPCAT_VOICES[] = {'H','K','E','Y','_','L','O','C','A','L','_','M','A','C','H','I','N','E','\\\\','S','O','F','T','W','A','R','E','\\\\','M','i','c','r','o','s','o','f','t','\\\\','S','p','e','e','c','h','\\\\','V','o','i','c','e','s',0};")
 647
 648 cpp_quote("#endif")
 649
 650 interface IEnumSpObjectTokens;
 651 interface ISpEventSource;
 652 interface ISpRecoContext;
 653 interface ISpRecognizer;
 654 interface ISpStreamFormat;
 655 interface ISpVoice;
 656
 657 [
 658     object,
 659     uuid(14056581-e16c-11d2-bb90-00c04f8ee6c0),
 660     helpstring("ISpDataKey"),
 661     pointer_default(unique),
 662     local,
 663     restricted
 664 ]
 665 interface ISpDataKey : IUnknown
 666 {
 667     HRESULT SetData([in] LPCWSTR pszValueName,
 668                     [in] ULONG cbData,
 669                     [in] const BYTE *pData);
 670     HRESULT GetData([in] LPCWSTR pszValueName,
 671                     [in] ULONG *pcbData,
 672                     [out] BYTE *pData);
 673     HRESULT SetStringValue([in] LPCWSTR pszValueName,
 674                            [in] LPCWSTR pszValue);
 675     HRESULT GetStringValue([in] LPCWSTR pszValueName,
 676                            [out] LPWSTR *ppszValue);
 677     HRESULT SetDWORD([in] LPCWSTR pszValueName,
 678                      [in] DWORD dwValue);
 679     HRESULT GetDWORD([in] LPCWSTR pszValueName,
 680                      [out] DWORD *pdwValue);
 681     HRESULT OpenKey([in] LPCWSTR pszSubKeyName,
 682                     [out] ISpDataKey **ppSubKey);
 683     HRESULT CreateKey([in] LPCWSTR pszSubKey,
 684                       [out] ISpDataKey **ppSubKey);
 685     HRESULT DeleteKey([in] LPCWSTR pszSubKey);
 686     HRESULT DeleteValue([in] LPCWSTR pszValueName);
 687     HRESULT EnumKeys([in] ULONG Index,
 688                      [out] LPWSTR *ppszSubKeyName);
 689     HRESULT EnumValues([in] ULONG Index,
 690                        [out] LPWSTR *ppszValueName);
 691 }
 692 [
 693     object,
 694     uuid(92a66e2b-c830-4149-83df-6fc2ba1e7a5b),
 695     helpstring("ISpRegDataKey"),
 696     pointer_default(unique),
 697     restricted
 698 ]
 699 interface ISpRegDataKey : ISpDataKey
 700 {
 701     [local] HRESULT SetKey([in] HKEY hkey, [in] BOOL fReadOnly);
 702 }
 703
 704 [
 705     object,
 706     uuid(2d3d3845-39af-4850-bbf9-40b49780011d),
 707     helpstring("ISpObjectTokenCategory"),
 708     pointer_default(unique),
 709     local,
 710     restricted
 711 ]
 712 interface ISpObjectTokenCategory : ISpDataKey
 713 {
 714     HRESULT SetId([in] LPCWSTR pszCategoryId,
 715                   [in] BOOL fCreateIfNotExist);
 716     HRESULT GetId([out] LPWSTR *ppszCoMemCategoryId);
 717     HRESULT GetDataKey([in] SPDATAKEYLOCATION spdkl,
 718                        [out] ISpDataKey **ppDataKey);
 719     HRESULT EnumTokens([in, string] LPCWSTR pszReqAttribs,
 720                        [in, string] LPCWSTR pszOptAttribs,
 721                        [out] IEnumSpObjectTokens **ppEnum);
 722     HRESULT SetDefaultTokenId([in] LPCWSTR pszTokenId);
 723     HRESULT GetDefaultTokenId([out] LPWSTR *ppszCoMemTokenId);
 724 }
 725
 726 [
 727     object,
 728     uuid(14056589-e16c-11d2-bb90-00c04f8ee6c0),
 729     helpstring("ISpObjectToken"),
 730     pointer_default(unique),
 731     local,
 732     restricted
 733 ]
 734 interface ISpObjectToken : ISpDataKey
 735 {
 736     HRESULT SetId(/*[in]*/ LPCWSTR pszCategoryId,
 737                   [in] LPCWSTR pszTokenId,
 738                   [in] BOOL fCreateIfNotExist);
 739     HRESULT GetId([out] LPWSTR *ppszCoMemTokenId);
 740     HRESULT GetCategory([out] ISpObjectTokenCategory **ppTokenCategory);
 741     HRESULT CreateInstance([in] IUnknown *pUnkOuter,
 742                            [in] DWORD dwClsContext,
 743                            [in] REFIID riid,
 744                            [out, iid_is(riid)] void **ppvObject);
 745     HRESULT GetStorageFileName([in] REFCLSID clsidCaller,
 746                                [in] LPCWSTR pszValueName,
 747                                [in, string] LPCWSTR pszFileNameSpecifier,
 748                                [in] ULONG nFolder,
 749                                [out] LPWSTR *ppszFilePath);
 750     HRESULT RemoveStorageFileName([in] REFCLSID clsidCaller,
 751                                   [in] LPCWSTR pszKeyName,
 752                                   [in] BOOL fDeleteFile);
 753     HRESULT Remove(/*[in]*/ const CLSID *pclsidCaller);
 754     [local] HRESULT IsUISupported([in] LPCWSTR pszTypeOfUI,
 755                                   [in] void *pvExtraData,
 756                                   [in] ULONG cbExtraData,
 757                                   [in] IUnknown *punkObject,
 758                                   [out] BOOL *pfSupported);
 759     [local] HRESULT DisplayUI([in] HWND hwndParent,
 760                               [in] LPCWSTR pszTitle,
 761                               [in] LPCWSTR pszTypeOfUI,
 762                               [in] void *pvExtraData,
 763                               [in] ULONG cbExtraData,
 764                               [in] IUnknown *punkObject);
 765     HRESULT MatchesAttributes([in] LPCWSTR pszAttributes,
 766                               [out] BOOL *pfMatches);
 767 }
 768
 769 [
 770     object,
 771     uuid(06b64f9e-7fda-11d2-b4f2-00c04f797396),
 772     helpstring("IEnumSpObjectTokens"),
 773     pointer_default(unique),
 774     local,
 775     restricted
 776 ]
 777 interface IEnumSpObjectTokens : IUnknown
 778 {
 779     HRESULT Next([in] ULONG celt,
 780                  [out, size_is(celt), length_is(*pceltFetched)] ISpObjectToken **pelt,
 781                  [out] ULONG *pceltFetched);
 782     HRESULT Skip([in] ULONG celt);
 783     HRESULT Reset(void);
 784     HRESULT Clone([out] IEnumSpObjectTokens **ppEnum);
 785     HRESULT Item([in] ULONG Index,
 786                  [out] ISpObjectToken **ppToken);
 787     HRESULT GetCount([out] ULONG *pCount);
 788 }
 789
 790 [
 791     object,
 792     uuid(93384e18-5014-43d5-adbb-a78e055926bd),
 793     helpstring("ISpResourceManager"),
 794     pointer_default(unique),
 795     restricted
 796 ]
 797 interface ISpResourceManager : IServiceProvider
 798 {
 799     HRESULT SetObject([in] REFGUID guidServiceId,
 800                       [in] IUnknown *pUnkObject);
 801     HRESULT GetObject([in] REFGUID guidServiceId,
 802                       [in] REFCLSID ObjectCLSID,
 803                       [in] REFIID ObjectIID,
 804                       [in] BOOL fReleaseWhenLastExternalRefReleased,
 805                       [out, iid_is(ObjectIID)] void** ppObject);
 806 }
 807
 808 [
 809     object,
 810     uuid(1a5c0354-b621-4b5a-8791-d306ed379e53),
 811     local,
 812     pointer_default(unique),
 813     restricted
 814 ]
 815 interface ISpPhrase : IUnknown
 816 {
 817     HRESULT GetPhrase([out] SPPHRASE **phrase);
 818     HRESULT GetSerializedPhrase([out] SPSERIALIZEDPHRASE **phrase);
 819     HRESULT GetText([in] ULONG start, [in] ULONG count, [in] BOOL replacements,
 820                                         [out] WCHAR **text, [out] BYTE *attributes);
 821     HRESULT Discard([in] DWORD types);
 822 };
 823
 824 [
 825     object,
 826     uuid(8fcebc98-4e49-4067-9c6c-d86a0e092e3d),
 827     local,
 828     pointer_default(unique),
 829     restricted
 830 ]
 831 interface ISpPhraseAlt : ISpPhrase
 832 {
 833     HRESULT GetAltInfo(ISpPhrase **parent, ULONG *start, ULONG *count,
 834                         ULONG *elements);
 835     HRESULT Commit();
 836 };
 837
 838 [
 839     object,
 840     uuid(20b053be-e235-43cd-9a2a-8d17a48b7842),
 841     pointer_default(unique),
 842     local,
 843     restricted
 844 ]
 845 interface ISpRecoResult : ISpPhrase
 846 {
 847     HRESULT GetResultTimes([out] SPRECORESULTTIMES *times);
 848
 849     HRESULT GetAlternates(
 850                 [in] ULONG start,
 851                 [in] ULONG elements,
 852                 [in] ULONG count,
 853                 [out] ISpPhraseAlt **phrases,
 854                 [out] ULONG *returned);
 855
 856     HRESULT GetAudio(
 857                 [in] ULONG start,
 858                 [in] ULONG elements,
 859                 [out] ISpStreamFormat **stream);
 860     HRESULT SpeakAudio(
 861                 [in] ULONG start,
 862                 [in] ULONG elements,
 863                 [in] DWORD flags,
 864                 [out] ULONG *number);
 865
 866     HRESULT Serialize([out] SPSERIALIZEDRESULT **result);
 867
 868     HRESULT ScaleAudio([in] const GUID *format, [in] const WAVEFORMATEX *wave);
 869
 870     HRESULT GetRecoContext([out] ISpRecoContext *context);
 871 };
 872
 873 [
 874     object,
 875     uuid(8137828f-591a-4a42-be58-49ea7ebaac68),
 876     helpstring("ISpGrammarBuilder Interface"),
 877     pointer_default(unique),
 878     restricted,
 879     local
 880 ]
 881 interface ISpGrammarBuilder : IUnknown
 882 {
 883     HRESULT ResetGrammar([in] LANGID language);
 884
 885     HRESULT GetRule([in] const WCHAR *rule,
 886                     [in] DWORD id,
 887                     [in] DWORD attributes,
 888                     [in] BOOL should_create,
 889                     [out] SPSTATEHANDLE *state);
 890     HRESULT ClearRule(SPSTATEHANDLE state);
 891
 892     HRESULT CreateNewState(
 893                 [in] SPSTATEHANDLE instate,
 894                 [out] SPSTATEHANDLE *outstate);
 895
 896     HRESULT AddWordTransition(
 897                     [in] SPSTATEHANDLE from_state,
 898                     [in] SPSTATEHANDLE to_state,
 899                     [in] const WCHAR *value,
 900                     [in] const WCHAR *separators,
 901                     [in] SPGRAMMARWORDTYPE type,
 902                     [in] float weight,
 903                     [in] const SPPROPERTYINFO *info);
 904
 905     HRESULT AddRuleTransition(
 906                 [in] SPSTATEHANDLE from_state,
 907                 [in] SPSTATEHANDLE to_state,
 908                 [in] SPSTATEHANDLE rule,
 909                 [in] float weight,
 910                 [in] const SPPROPERTYINFO *info);
 911
 912     HRESULT AddResource([in] SPSTATEHANDLE state,
 913                         [in] const WCHAR *name,
 914                         [in] const WCHAR *value);
 915
 916     HRESULT Commit([in] DWORD reserved);
 917 };
 918
 919 [
 920     object,
 921     uuid(2177db29-7f45-47d0-8554-067e91c80502),
 922     pointer_default(unique),
 923     restricted,
 924     local
 925 ]
 926 interface ISpRecoGrammar : ISpGrammarBuilder
 927 {
 928     HRESULT GetGrammarId([out] ULONGLONG *grammar);
 929     HRESULT GetRecoContext([out] ISpRecoContext **context);
 930
 931     HRESULT LoadCmdFromFile([in, string] const WCHAR * pszFileName, [in] SPLOADOPTIONS options);
 932     HRESULT LoadCmdFromObject([in] REFCLSID rcid, [in, string] const WCHAR * pszGrammarName, [in] SPLOADOPTIONS options);
 933     HRESULT LoadCmdFromResource([in] HMODULE hmod,
 934                                 [in, string] const WCHAR *name,
 935                                 [in, string] const WCHAR *type,
 936                                 [in] WORD language,
 937                                 [in] SPLOADOPTIONS options);
 938     HRESULT LoadCmdFromMemory([in] const SPBINARYGRAMMAR *grammar, [in] SPLOADOPTIONS options);
 939     HRESULT LoadCmdFromProprietaryGrammar(
 940                                 [in] REFGUID guid,
 941                                 [in, string] const WCHAR *param,
 942                                 [in] const void *data,
 943                                 [in] ULONG size,
 944                                 [in] SPLOADOPTIONS options);
 945     HRESULT SetRuleState([in, string] const WCHAR *name, [in] void *reserved,
 946                          [in] SPRULESTATE state);
 947     HRESULT SetRuleIdState([in] ULONG rule, [in] SPRULESTATE state);
 948
 949     HRESULT LoadDictation([in, string] const WCHAR *name, [in] SPLOADOPTIONS options);
 950     HRESULT UnloadDictation();
 951     HRESULT SetDictationState([in] SPRULESTATE state);
 952
 953     HRESULT SetWordSequenceData([in] const WCHAR *text, [in] ULONG count, [in] const SPTEXTSELECTIONINFO *info);
 954     HRESULT SetTextSelection([in] const SPTEXTSELECTIONINFO *info);
 955
 956     HRESULT IsPronounceable([in, string] const WCHAR *word, [out] SPWORDPRONOUNCEABLE *pronounceable);
 957
 958     HRESULT SetGrammarState([in] SPGRAMMARSTATE state);
 959
 960     HRESULT SaveCmd([in] IStream *stream, [out, optional] WCHAR **error);
 961
 962     HRESULT GetGrammarState([out] SPGRAMMARSTATE *state);
 963 };
 964
 965 [
 966     object,
 967     uuid(259684dc-37c3-11d2-9603-00c04f8ee628),
 968     pointer_default(unique),
 969     restricted
 970 ]
 971 interface ISpNotifySink : IUnknown
 972 {
 973     HRESULT Notify(void);
 974 }
 975
 976 [
 977     object,
 978     uuid(5eff4aef-8487-11d2-961c-00c04f8ee628),
 979     pointer_default(unique),
 980     restricted
 981 ]
 982 interface ISpNotifySource : IUnknown
 983 {
 984     HRESULT SetNotifySink([in] ISpNotifySink *sink);
 985     [local] HRESULT SetNotifyWindowMessage(
 986                 [in] HWND hwnd,
 987                 [in] UINT msg,
 988                 [in] WPARAM wparam,
 989                 [in] LPARAM lparam);
 990     [local] HRESULT SetNotifyCallbackFunction(
 991                 [in] SPNOTIFYCALLBACK *callback,
 992                 [in] WPARAM wparam,
 993                 [in] LPARAM lparam);
 994     [local] HRESULT SetNotifyCallbackInterface(
 995                 [in] ISpNotifyCallback *callback,
 996                 [in] WPARAM wparam,
 997                 [in] LPARAM lparam);
 998     [local] HRESULT SetNotifyWin32Event(void);
 999     [local] HRESULT WaitForNotifyEvent([in] DWORD milliseconds);
1000     [local] HANDLE  GetNotifyEventHandle();
1001 }
1002
1003 [
1004     object,
1005     uuid(be7a9cce-5f9e-11d2-960f-00c04f8ee628),
1006     pointer_default(unique),
1007     local,
1008     restricted
1009 ]
1010 interface ISpEventSource : ISpNotifySource
1011 {
1012     HRESULT SetInterest([in] ULONGLONG event, [in] ULONGLONG queued);
1013     HRESULT GetEvents([in] ULONG count,
1014                     [out, size_is(count)] SPEVENT *array,
1015                     [out] ULONG *fetched);
1016     HRESULT GetInfo([out] SPEVENTSOURCEINFO *info);
1017 };
1018
1019 [
1020     object,
1021     uuid(f740a62f-7c15-489e-8234-940a33d9272d),
1022     pointer_default(unique),
1023     local,
1024     restricted
1025 ]
1026 interface ISpRecoContext : ISpEventSource
1027 {
1028     HRESULT GetRecognizer([out] ISpRecognizer **recognizer);
1029
1030     HRESULT CreateGrammar([in] ULONGLONG grammar, [out] ISpRecoGrammar **spgrammar);
1031
1032     HRESULT GetStatus([out] SPRECOCONTEXTSTATUS *status);
1033
1034     HRESULT GetMaxAlternates([in] ULONG *alternates);
1035     HRESULT SetMaxAlternates([in] ULONG alternates);
1036
1037     HRESULT SetAudioOptions([in] SPAUDIOOPTIONS options, [in] const GUID *format, [in] const WAVEFORMATEX *wave);
1038     HRESULT GetAudioOptions([in] SPAUDIOOPTIONS *options, [out] GUID *format, [out] WAVEFORMATEX **wave);
1039
1040     HRESULT DeserializeResult([in] const SPSERIALIZEDRESULT *serialized, [out] ISpRecoResult **result);
1041
1042     HRESULT Bookmark([in] SPBOOKMARKOPTIONS options, [in] ULONGLONG position, [in] LPARAM event);
1043
1044     HRESULT SetAdaptationData([in, string] const WCHAR *data, [in] const ULONG count);
1045
1046     HRESULT Pause(DWORD reserved);
1047     HRESULT Resume(DWORD reserved);
1048
1049     HRESULT SetVoice([in] ISpVoice *voice, [in] BOOL changes);
1050     HRESULT GetVoice([out] ISpVoice **voice);
1051     HRESULT SetVoicePurgeEvent([in] ULONGLONG interest);
1052     HRESULT GetVoicePurgeEvent([out] ULONGLONG *interest);
1053
1054     HRESULT SetContextState([in] SPCONTEXTSTATE state);
1055     HRESULT GetContextState([in] SPCONTEXTSTATE *state);
1056 };
1057
1058 [
1059     object,
1060     uuid(6c44df74-72b9-4992-a1ec-ef996e0422d4),
1061     pointer_default(unique),
1062     restricted
1063 ]
1064 interface ISpVoice : ISpEventSource
1065 {
1066     HRESULT SetOutput([in] IUnknown *unk, [in] BOOL changes);
1067     HRESULT GetOutputObjectToken([out] ISpObjectToken **token);
1068     HRESULT GetOutputStream([out] ISpStreamFormat **stream);
1069
1070     HRESULT Pause(void);
1071     HRESULT Resume(void);
1072
1073     HRESULT SetVoice([in] ISpObjectToken *token);
1074     HRESULT GetVoice([out] ISpObjectToken **token);
1075
1076     HRESULT Speak([in, string] const WCHAR *pwcs,
1077                 [in] DWORD flags,
1078                 [out] ULONG *number);
1079     HRESULT SpeakStream([in] IStream *stream,
1080                 [in] DWORD flags,
1081                 [out] ULONG *number);
1082
1083     HRESULT GetStatus(
1084                 [out] SPVOICESTATUS *status,
1085                 [out, string] WCHAR **bookmark);
1086
1087     HRESULT Skip([in,string] const WCHAR *type, [in] long items, [out] ULONG *skipped);
1088
1089     HRESULT SetPriority([in] SPVPRIORITY priority);
1090     HRESULT GetPriority([out] SPVPRIORITY* priority);
1091
1092     HRESULT SetAlertBoundary([in] SPEVENTENUM boundary);
1093     HRESULT GetAlertBoundary([out] SPEVENTENUM* boundary);
1094
1095     HRESULT SetRate([in] long adjust);
1096     HRESULT GetRate([out] long *adjust);
1097
1098     HRESULT SetVolume([in] USHORT volume);
1099     HRESULT GetVolume([out] USHORT *volume);
1100
1101     HRESULT WaitUntilDone([in] ULONG timeout);
1102
1103     HRESULT SetSyncSpeakTimeout([in] ULONG timeout);
1104     HRESULT GetSyncSpeakTimeout([out] ULONG *timeout);
1105
1106     [local] HANDLE SpeakCompleteEvent();
1107
1108     [local] HRESULT IsUISupported(
1109                 [in] const WCHAR *type,
1110                 [in] void * extra,
1111                 [in] ULONG count,
1112                 [out] BOOL *supported);
1113     [local] HRESULT DisplayUI(
1114                 [in] HWND parent,
1115                 [in] const WCHAR *title,
1116                 [in] const WCHAR *type,
1117                 [in] void *extra,
1118                 [in] ULONG count);
1119 };
1120
1121 [
1122     object,
1123     uuid(be7a9cc9-5f9e-11d2-960f-00c04f8ee628),
1124     pointer_default(unique),
1125     local,
1126     restricted
1127 ]
1128 interface ISpEventSink : IUnknown
1129 {
1130     HRESULT AddEvents([in] const SPEVENT *events, [in] ULONG count);
1131     HRESULT GetEventInterest([out] ULONGLONG *interest);
1132 };
1133
1134 [
1135     object,
1136     uuid(5b559f40-e952-11d2-bb91-00c04f8ee6c0),
1137     pointer_default(unique),
1138     restricted
1139 ]
1140 interface ISpObjectWithToken : IUnknown
1141 {
1142     HRESULT SetObjectToken([in] ISpObjectToken *token);
1143     HRESULT GetObjectToken([out] ISpObjectToken **token);
1144 };
1145
1146 [
1147     object,
1148     uuid(bed530be-2606-4f4d-a1c0-54c5cda5566f),
1149     pointer_default(unique),
1150     restricted
1151 ]
1152 interface ISpStreamFormat : IStream
1153 {
1154     HRESULT GetFormat(GUID *format, WAVEFORMATEX **wave);
1155 }
1156
1157 [
1158     object,
1159     uuid(c05c768f-fae8-4ec2-8e07-338321c12452),
1160     pointer_default(unique),
1161     local,
1162     restricted
1163 ]
1164 interface ISpAudio : ISpStreamFormat
1165 {
1166     HRESULT SetState([in] SPAUDIOSTATE state, [in] ULONGLONG reserved);
1167     HRESULT SetFormat([in] REFGUID guid, [in] const WAVEFORMATEX *wave);
1168     HRESULT GetStatus([out] SPAUDIOSTATUS *status);
1169     HRESULT SetBufferInfo([in] const SPAUDIOBUFFERINFO *buffer);
1170     HRESULT GetBufferInfo([out] SPAUDIOBUFFERINFO *buffer);
1171     HRESULT GetDefaultFormat([out] GUID *guid, [out] WAVEFORMATEX **wave);
1172     HANDLE  EventHandle();
1173     HRESULT GetVolumeLevel([out] ULONG *level);
1174     HRESULT SetVolumeLevel([in] ULONG level);
1175     HRESULT GetBufferNotifySize([out] ULONG *size);
1176     HRESULT SetBufferNotifySize([in] ULONG size);
1177 };
1178 [
1179     object,
1180     uuid(15806f6e-1d70-4b48-98e6-3b1a007509ab),
1181     pointer_default(unique),
1182     local,
1183     restricted
1184 ]
1185 interface ISpMMSysAudio : ISpAudio
1186 {
1187     HRESULT GetDeviceId([out] UINT *id);
1188     HRESULT SetDeviceId([in] UINT id);
1189     HRESULT GetMMHandle([out] void **handle);
1190     HRESULT GetLineId([out] UINT *id);
1191     HRESULT SetLineId([in] UINT id);
1192 };
1193
1194 [
1195     object,
1196     uuid(5b4fb971-b115-4de1-ad97-e482e3bf6ee4),
1197     pointer_default(unique),
1198     local,
1199     restricted
1200 ]
1201 interface ISpProperties : IUnknown
1202 {
1203     HRESULT SetPropertyNum([in] const WCHAR *name, [in] long value);
1204     HRESULT GetPropertyNum([in] const WCHAR *name, [out] long *value);
1205     HRESULT SetPropertyString([in] const WCHAR *name, [in] const WCHAR *value);
1206     HRESULT GetPropertyString([in] const WCHAR *name, [out] WCHAR **value);
1207 };
1208
1209 [
1210     object,
1211     uuid(c2b5f241-daa0-4507-9e16-5a1eaa2b7a5c),
1212     pointer_default(unique),
1213     restricted
1214 ]
1215 interface ISpRecognizer : ISpProperties
1216 {
1217     HRESULT SetRecognizer([in] ISpObjectToken *recognizer);
1218     HRESULT GetRecognizer([out] ISpObjectToken **recognizer);
1219
1220     HRESULT SetInput([in] IUnknown *input, [in] BOOL changes);
1221     HRESULT GetInputObjectToken([out] ISpObjectToken **token);
1222
1223     HRESULT GetInputStream( [out] ISpStreamFormat **stream);
1224     HRESULT CreateRecoContext([out] ISpRecoContext **cxt);
1225
1226     HRESULT GetRecoProfile([out] ISpObjectToken **token);
1227     HRESULT SetRecoProfile([in] ISpObjectToken *token);
1228
1229     HRESULT IsSharedInstance(void);
1230
1231     HRESULT GetRecoState([out] SPRECOSTATE *state);
1232     HRESULT SetRecoState([in] SPRECOSTATE state);
1233
1234     HRESULT GetStatus([out] SPRECOGNIZERSTATUS *status);
1235     HRESULT GetFormat([in] SPSTREAMFORMATTYPE type, [out] GUID *format, [out] WAVEFORMATEX **wave);
1236
1237     [local] HRESULT IsUISupported([in] const WCHAR *type, [in] void *extra, [in] ULONG count,
1238                 [out] BOOL *supported);
1239     [local] HRESULT DisplayUI([in] HWND hwnd,[in] const WCHAR *title, [in] const WCHAR *type,
1240                 [in] void *extra, [in] ULONG cnt);
1241     HRESULT EmulateRecognition([in] ISpPhrase *phrase);
1242 };
1243
1244 [
1245     object,
1246     uuid(12e3cca9-7518-44c5-a5e7-ba5a79cb929e),
1247     pointer_default(unique),
1248     local,
1249     restricted
1250 ]
1251 interface ISpStream : ISpStreamFormat
1252 {
1253     HRESULT SetBaseStream([in] IStream *stream, [in] REFGUID format, [in] const WAVEFORMATEX *wave);
1254     HRESULT GetBaseStream([out] IStream **stream);
1255     HRESULT BindToFile([in] LPCWSTR filename, [in] SPFILEMODE mode, [in] const GUID *format,
1256                        const WAVEFORMATEX *wave, [in] ULONGLONG interest);
1257     HRESULT Close();
1258 }
1259
1260 [
1261     helpstring("Speech Object Library"),
1262     uuid(c866ca3a-32f7-11d2-9602-00c04f8ee628),
1263     version(5.4)
1264 ]
1265 library SpeechLib
1266 {
1267     importlib("stdole2.tlb");
1268
1269 #include "sapiaut.idl"
1270
1271     [
1272         uuid(a910187f-0c7a-45ac-92cc-59edafb77b53),
1273         helpstring("SpObjectTokenCategory Class"),
1274         progid("SAPI.SpObjectTokenCategory.1"),
1275         vi_progid("SAPI.SpObjectTokenCategory"),
1276         threading(both)
1277     ]
1278     coclass SpObjectTokenCategory
1279     {
1280         interface ISpObjectTokenCategory;
1281     }
1282
1283     [
1284         uuid(ef411752-3736-4cb4-9c8c-8ef4ccb58efe),
1285         helpstring("Object Token"),
1286         progid("SAPI.SpObjectToken.1"),
1287         vi_progid("SAPI.SpObjectToken"),
1288         threading(both)
1289     ]
1290     coclass SpObjectToken
1291     {
1292         interface ISpObjectToken;
1293         [default] interface ISpDataKey;
1294     }
1295
1296     [
1297         uuid(96749373-3391-11d2-9ee3-00c04f797396),
1298         helpstring("Resource Manager"),
1299         progid("SAPI.SpResourceManager.1"),
1300         vi_progid("SAPI.SpResourceManager"),
1301         threading(both),
1302         restricted,
1303         hidden
1304     ]
1305     coclass SpResourceManager
1306     {
1307         [default] interface ISpResourceManager;
1308     };
1309
1310     [
1311         uuid(3bee4890-4fe9-4a37-8c1e-5e7e12791c1f)
1312     ]
1313     coclass SpSharedRecognizer
1314     {
1315         /*[default] interface ISpeechRecognizer;*/
1316         interface ISpRecognizer;
1317     };
1318
1319     [
1320         uuid(715d9c59-4442-11d2-9605-00c04f8ee628),
1321         helpstring("Speech Stream"),
1322         progid("SAPI.SpStream.1"),
1323         vi_progid("SAPI.SpStream"),
1324         threading(both),
1325         restricted,
1326         hidden
1327     ]
1328     coclass SpStream
1329     {
1330         interface ISpStream;
1331     };
1332
1333     [
1334         uuid(96749377-3391-11d2-9ee3-00c04f797396)
1335     ]
1336     coclass SpVoice
1337     {
1338         interface ISpVoice;
1339         [default] interface ISpeechVoice;
1340     };
1341
1342     [
1343         uuid(947812b3-2ae1-4644-ba86-9e90ded7ec91),
1344     ]
1345     coclass SpFileStream
1346     {
1347         interface ISpStream;
1348         [default] interface ISpeechFileStream;
1349     };
1350
1351     [
1352         uuid(ab1890a0-e91f-11d2-bb91-00c04f8ee6c0),
1353         restricted,
1354         hidden
1355     ]
1356     coclass SpMMAudioEnum
1357     {
1358         interface IEnumSpObjectTokens;
1359     };
1360
1361     [
1362         uuid(cf3d2e50-53f2-11d2-960c-00c04f8ee628)
1363     ]
1364     coclass SpMMAudioIn
1365     {
1366         interface ISpEventSource;
1367         interface ISpEventSink;
1368         interface ISpObjectWithToken;
1369         interface ISpMMSysAudio;
1370     };
1371
1372     [
1373         uuid(a8c680eb-3d32-11d2-9ee7-00c04f797396)
1374     ]
1375     coclass SpMMAudioOut
1376     {
1377         interface ISpEventSource;
1378         interface ISpEventSink;
1379         interface ISpObjectWithToken;
1380         interface ISpMMSysAudio;
1381     };
1382 }