Share via

ISpSREngine::SetContextState (SAPI 5.3)

  • Article

Microsoft Speech API 5.3

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
S_OK
FAILED(hr)

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.