ISpRecognizer::SetRecoState (SAPI 5.4)
ISpRecognizer::SetRecoState sets the state of the recognition engine.
HRESULT SetRecoState( SPRECOSTATE NewState );
- [in] One of the flags contained in the SPRECOSTATE enumeration.
|S_OK||Function completed successfully.|
|FAILED(hr)||Appropriate error message.|
|E_INVALIDARG||One or more parameters are invalid.|
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.