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.