SPRECOSTATE

This enumeration defines engine recognition states.

typedef enum SPRECOSTATE{
  SPRST_INACTIVE,
  SPRST_ACTIVE,
  SPRST_ACTIVE_ALWAYS,
  SPRST_INACTIVE_WITH_PURGE,
  SPRST_NUM_STATES
} SPRECOSTATE;

Elements

  • SPRST_INACTIVE
    The engine and audio input are inactive and no audio is being read. Even if there are some active rules, recognition will not be started.
  • SPRST_ACTIVE
    Recognition takes place if there are any active rules. For active rules, audio is read and passed to the SR engine so that recognition can occur. This state is the default.
  • SPRST_ACTIVE_ALWAYS
    Audio is running regardless of the rule state. Even if there are no active rules, audio is read and passed to the engine. This state can be useful if applications want to receive volume-level events (SPEI_SR_AUDIO_LEVEL), in order to display a VU-meter or similar. See the SPEVENTENUM enumeration.
  • SPRST_INACTIVE_WITH_PURGE
    Engine state is set to inactive, but all active audio data is purged. This state is used when an application wants to shut an engine down as quickly as possible, without waiting for it to finish processing audio data that is currently buffered.
  • SPRST_NUM_STATES
    Limit checking.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.

See Also

SAPI Enumerations

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.