Microsoft Speech SDK
SAPI 5.1
ISpSREngine::SetContextState
ISpSREngine::SetContextState indicates that a recognition context has been activated or deactivated by the application calling ISpRecoContext::SetContextState.
HRESULT SetContextState(
void * pvEngineContext,
SPCONTEXTSTATE eContextState
);
Parameters
- pvEngineContext
- [in] Pointer to the engine's data for this context, as returned from a previous call to OnCreateRecoContext.
- eContextState
- [in] The SPCONTEXTSTATE enumeration value specifying the new recognition context state.
Return values
Value | Description |
---|---|
S_OK | Function completed successfully. |
FAILED(hr) | Appropriate error message. |
Remarks
When using standard CFG and dictation grammars, the engine may not need to be informed of the context state, as SAPI will automatically activate and deactivate the grammars as necessary. However, when using proprietary grammars, it may be necessary to look at this information.