Partager via

ISpSREngine::LoadProprietaryGrammar (SAPI 5.3)

  • Article

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

Value
S_OK
FAILED (hr)

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.