SpeechRecognizer.PauseRecognizerOnRecognition Property

Gets and sets a value indicating whether a SpeechRecognizer based recognition engine pause while an application is handling SpeechRecognized events.

Namespace: System.Speech.Recognition
Assembly: System.Speech (in system.speech.dll)

public bool PauseRecognizerOnRecognition { get; set; }
/** @property */
public boolean get_PauseRecognizerOnRecognition ()

/** @property */
public void set_PauseRecognizerOnRecognition (boolean value)

public function get PauseRecognizerOnRecognition () : boolean

public function set PauseRecognizerOnRecognition (value : boolean)

Not applicable.

Property Value

Property is a bool value which is set to true if an instance of SpeechRecognizer is will pause while handlers subscribed to SpeechRecognized are executing, and false if the SpeechRecognizer will continue to execute while the handler is executing.

The ability to pause the underlying recognition engines during the execution of handlers subscribed to SpeechRecognized is provided because Windows Desktop Speech Technology are a shared resource and can be used multiple applications and processes. Certain requests to change recognition engine configuration, such as loading or unloading grammars, may not necessarily be synchronous with the client application making the request.

By setting PauseRecognizerOnRecognition to true, an application can synchronously modify the recognition engine state while within SpeechRecognized handler.

When pausing, the Windows Desktop Speech Technology must finish processing any current audio input, which can take some time, and blocks the system. Applications using pausing on recognition should therefore undertake simple, quick modifications.

For information on asynchronous, non-blocking, atomic updates to the state of the Windows Desktop Speech Technology recognition engine, see RequestRecognizerUpdate.

When the Windows Desktop Speech Technology recognition engine is paused during the execution of the SpeechRecognized handler because PauseRecognizerOnRecognition is set to true, the Windows Desktop Speech Technology maintains the audio input buffer, retains the location of its last read, and stores new audio input as it arrives. Following completion of the handler for SpeechRecognized, when the Windows Desktop Speech Technology recognition engine is no longer paused, the recognition engine will process all information in the audio input buffer.

Compare this behavior with the behavior of the Windows Desktop Speech Technology when Enabled is modified.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions