ISpSREngine::OnCreateGrammar (Windows CE 5.0)
This method informs the SR engine of the creation of a new speech recognition grammar. Each grammar can contain dictation, CFG, or proprietary grammar information, and belongs to a specific speech recognition context (ISpRecoContext).
This method associates a pointer with the new grammar. SAPI passes this pointer when calling other methods for the grammar.
HRESULT OnCreateGrammar( void* pvEngineRecoContext, SPGRAMMARHANDLE hSAPIGrammar, void** ppvEngineGrammar);
Parameters
- pvEngineRecoContext
[in] Pointer to the speech recognition context to which the grammar belongs. The pointer is retrieved by a prior call to the ISpSREngine::OnCreateRecoContext method. - hSAPIGrammar
[in] Unique handle to the grammar. - ppvEngineGrammar
[out] Address of an arbitrary pointer to information that the engine has associated with the grammar.
Return Values
The following table shows the possible return values.
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| FAILED(hr) | Appropriate error message. |
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sapiddk.h, Sapiddk.idl.
Link Library: Sapilib.lib.
See Also
Send Feedback on this topic to the authors