Share via


ISpRecoContext::SetContextState (SAPI 5.4)

Microsoft Speech API 5.4

ISpRecoContext::SetContextState

ISpRecoContext::SetContextState sets the state of the recognition context.

  
    HRESULT SetContextState(SPCONTEXTSTATE   eContextState
);

Parameters

  • eContextState
    [in] The SPCONTEXTSTATE enumeration sequence specifying the recognition context state.

Return values

Value
S_OK
E_INVALIDARG
FAILED(hr)

Remarks

The default recognition context state for an ISpRecoContext object is SPCS_ENABLED.

Applications can use ISpRecoContext::SetContextState to toggle sets of grammars. For example, a multi-document interface application that uses a different ISpRecoContext object for each document could toggle the context states as each document gained and lost the focus.  

Applications can use ISpRecoContext::GetContextState to query the context state.