ISpRecoGrammar (Windows Embedded CE 6.0)

1/6/2010

This interface enables applications to manage the words and phrases that the SR engine will recognize. It inherits from ISpGrammarBuilder.

Each object implementing ISpRecoGrammar can have a context-free grammar (CFG) and a dictation grammar loaded simultaneously (for example, using the CFG if possible, but returning to dictation if the CFG fails to parse). A single recognizer object implementing ISpRecognizer can have multiple speech recognition context objects (ISpRecoContext) associated with it. Similarly, a single context object can be associated with multiple objects implementing ISpRecoGrammar. This one-to-many relationship allows applications to separate types of recognizable phrases and content into separate objects for clearer application logic.

Methods

The following table lists methods for the ISpRecoGrammar interface.

Methods	Description
GetGrammarId	Gets the grammar identifier associated with the application.
GetGrammarState	Gets recognition grammar state information.
GetRecoContext	Gets the context object that created the grammar.
IsPronounceable	Determines if a word has a pronunciation.
LoadCmdFromFile	Loads a command and control grammar from a file.
LoadCmdFromMemory	Loads a command and control grammar from memory.
LoadCmdFromProprietaryGrammar	Loads an engine proprietary format command and control grammar.
LoadCmdFromResource	Loads a command and control grammar from a Win32 resource.
LoadDictation	Loads and initializes a dictation topic.
SaveCmd	Allows applications using dynamic grammars to save the current grammar state to a stream.
SetDictationState	Sets a dictation state to active or inactive.
SetGrammarState	Sets the state of a grammar. Changing the state affects the state of all the active rules in the grammar.
SetRuleIdState	Activates or deactivates a rule by its rule identifier.
SetRuleState	Activates or deactivates a rule by its rule name.
SetTextSelection	Sets the insertion point (using word sequence data buffer).
SetWordSequenceData	Sets word sequence data.
UnloadDictation	Unloads the active dictation topic from the grammar.

Requirements

Header	sapi.h, sapi.idl
Library	sapilib.lib
Windows Embedded CE	Windows CE .NET 4.1 and later

See Also

Reference

SAPI Interfaces