ISpRecognizer::GetRecoState (Windows CE 5.0)
This method gets the current state of the SR engine.
This method shows whether audio is currently being read from the audio input stream and passed to the SR engine.
See also ISpRecognizer::SetRecoState.
HRESULT GetRecoState(SPRECOSTATE* pState);
Parameters
- pState
[out] Pointer to the current state of the SR engine. Possible values are defined for the SPRECOSTATE enumeration.
Return Values
The following table shows the possible return values.
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_INVALIDARG | Invalid pointer. |
| FAILED(hr) | Appropriate error message. |
Remarks
The default recognizer state is SPRST_ACTIVE, which means SAPI will start the audio input stream only when at least one top-level rule is active.
If you would like to be notified when the recognizer state changes (for example, another application changes the shared SR engine's recognizer state), rather than polling the state with GetRecoState, you can call ISpEventSource::SetInterest with SPEI_RECO_STATE.
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.
Link Library: Sapilib.lib.
See Also
ISpRecognizer | SAPI Interfaces
Send Feedback on this topic to the authors