Microsoft Speech Platform

---

ISpRecognizer::SetRecoState

ISpRecognizer::SetRecoState sets the state of the recognition engine.

HRESULT SetRecoState(
   SPRECOSTATE   NewState
);

Parameters

NewState

[in] One of the flags contained in the SPRECOSTATE enumeration.

Return values

Value	Description
S_OK	Function completed successfully.
FAILED(hr)	Appropriate error message.
E_INVALIDARG	One or more parameters are invalid.

Remarks

When using the shared recognizer, the recognizer state is a global setting. If one application changes the recognizer state, it will affect all other applications connected to the shared recognizer. For this reason, applications using a shared recognizer should take great caution before calling SetRecoState.

Changing the recognition state leads to a SPEI_RECO_STATE_CHANGE event for all interested recognition contexts.