Share via


ISpRecoContext (Speech API (SAPI) SDK 5.1)

Microsoft Speech SDK Version 5.1

ISpRecoContext

The ISpRecoContext interface enables applications to create different functional views or contexts of the SR engine. Each ISpRecoContext object can take interest in different SR events (see also ISpEventSource and SPEVENTENUM) and use different recognition grammars (see also ISpRecoGrammar). Applications must have at least one ISpRecoContext instance to receive recognitions. Applications can also create multiple ISpRecoContext instances to separate different types of recognition with their application. For example, a multiple-document-interface (MDI) application could associate a different ISpRecoContext instance with each document pane to localize the grammar and support and event processing.

A new ISpRecoContext object can be created by calling ISpRecognizer::CreateRecoContext.

To use a shared recognizer (see description of ISpRecognizer), an application can easily create a shared ISpRecoContext by calling ::CoCreateInstance with CLSID_SpSharedRecoContext.

Associated Class IDs

The following class IDs (CLSID) may be used with this interface. A complete CLSID listing for all interfaces is in the Class IDs section.

Methods in Vtable Order

ISpRecoContext Methods
ISpEventSource
GetRecognizer
CreateGrammar
GetStatus
GetMaxAlternates
SetMaxAlternates
SetAudioOptions
GetAudioOptions
DeserializeResult
Bookmark
SetAdaptationData
Pause
Resume
SetVoice
GetVoice
SetVoicePurgeEvent
GetVoicePurgeEvent
SetContextState
GetContextState