Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

SpeechRecognizer State Property (SAPI 5.3)

Speech API 5.3
Microsoft Speech API 5.3

Interface: ISpeechRecognizer

State Property


The State property returns the current state of the recognition engine.

The recognition engine may be in one of several states of audio processing. If active, the engine receives audio data and processes it. Likewise, if inactive, neither audio data nor additional processing takes place. See the enumeration SpeechRecognizerState for complete details of the states.


Syntax

Set: SpeechRecognizer.State = SpeechRecognizerState
Get: SpeechRecognizerState = SpeechRecognizer.State

Parts

SpeechRecognizer
The owning object.
SpeechRecognizerState
Set: A SpeechRecognizerState variable that sets the property.
Get: A SpeechRecognizerState variable that gets the property.

Example

This code example demonstrates the State property. After creating an instance for a recognizer, the code retrieves and then changes the processing state of the recognizer.

To run this code, create a form with no controls. Paste this code into the Declarations section of the form.


Option Explicit

Private Sub Form_Load()
    On Error GoTo EH

    Dim RC As SpSharedRecoContext
    Dim T As String

    Set RC = New SpSharedRecoContext

    With RC.Recognizer
        If .State = SRSActive Then
            .State = SRSInactive
            T = "Recognition engine's state has been" & vbNewLine
            T = T & "changed from SRSActive to SRSInactive."
        End If
    End With

    MsgBox T, vbInformation

EH:
    If Err.Number Then ShowErrMsg
End Sub

Private Sub ShowErrMsg()

    ' Declare identifiers:
    Dim T As String

    T = "Desc: " & Err.Description & vbNewLine
    T = T & "Err #: " & Err.Number
    MsgBox T, vbExclamation, "Run-Time Error"
    End

End Sub
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.