Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

ISpSREngine::LoadProprietaryGrammar (SAPI 5.3)

Speech API 5.3
Microsoft Speech API 5.3

ISpSREngine::LoadProprietaryGrammar

ISpSREngine::LoadProprietaryGrammar instructs the engine to load a grammar in an engine-specific format. This is used to load grammars that are not in the standard SAPI CFG format.

HRESULT LoadProprietaryGrammar(
   void          *pvEngineGrammar,
   REFGUID        rguidParam,
   LPCWSTR       *pszStringParam,
   const void    *pvDataParam,
   ULONG          ulDataSize.
   SPLOADOPTIONS  Options
);

Parameters

pvEngineGrammar
[in] The engine's grammar pointer, as returned from the OnCreateGrammar method.
rguidParam
[in] Unique identifier for the grammar.
pszStringParam
[in, string] Null-terminated string containing proprietary grammar string data.
pvDataParam
[in] Pointer to grammar image data.
ulDataSize
[in] Size, in bytes, of the grammar image data.
Options
[in] One of the grammar loading options specified in the SPLOADOPTIONS enumeration sequence.

Return values

ValueDescription
S_OKFunction completed successfully.
FAILED (hr)Appropriate error message.

Remarks

The application can supply the engine with either a GUID, string data, or binary data or some combination of these, in order to describe the grammar. SAPI does nothing with this data apart from correctly marshaling it to the SR engine.

Show:
© 2015 Microsoft