Share via


SPPHRASEELEMENT

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This structure contains a phrase element for a spoken word.

Syntax

typedef [restricted] struct SPPHRASEELEMENT{
  ULONG ulAudioTimeOffset;
  ULONG ulAudioSizeTime;
  ULONG ulAudioStreamOffset;
  ULONG ulAudioSizeBytes;
  ULONG ulRetainedStreamOffset;
  ULONG ulRetainedSizeBytes;
  const WCHAR* pszDisplayText;
  const WCHAR* pszLexicalForm;
  const SPPHONEID* pszPronunciation;
  BYTE bDisplayAttributes;
  char RequiredConfidence;
  char ActualConfidence;
  BYTE Reserved;
  float SREngineConfidence;
} SPPHRASEELEMENT;

Members

  • ulAudioTimeOffset
    Starting offset of the element in 100-nanosecond units relative to the start of the phrase.
  • ulAudioSizeTime
    Length of the element in 100-nanosecond units.
  • ulAudioStreamOffset
    Starting offset of the element, in bytes, relative to the start of the phrase in the original input stream.
  • ulAudioSizeBytes
    Size of the element, in bytes, in the original input stream.
  • ulRetainedStreamOffset
    Starting offset of the element, in bytes, relative to the start of the phrase in the retained audio stream.
  • ulRetainedSizeBytes
    Size of the element, in bytes, in the retained audio stream.
  • pszDisplayText
    Pointer to display text for the element. For example, "2" for the spoken word "two".
  • pszLexicalForm
    Pointer to the lexical form of the element, for example, "two".
  • bDisplayAttributes
    Bit field of attributes defining additional display information that the application should honor when displaying the phrase element. Possible values are defined for the SPDISPLAYATTRIBUTES enumeration.
  • RequiredConfidence
    Required confidence for the element. Possible values are SP_LOW_CONFIDENCE, SP_NORMAL_CONFIDENCE, and SP_HIGH_CONFIDENCE. If a word is prefixed with a minus sign (-),the required confidence is SP_LOW_CONFIDENCE. A prefix of a plus sign (+) sets the required confidence to SP_HIGH_CONFIDENCE. For example, "This -is -a +test".
  • ActualConfidence
    Actual confidence for the element. Possible values are SP_LOW_CONFIDENCE, SP_NORMAL_CONFIDENCE, and SP_HIGH_CONFIDENCE. This value always reflects at least the required confidence. See RequiredConfidence.
  • Reserved
    Reserved for future use.
  • SREngineConfidence
    Confidence score computed by the SR engine. The value range is engine-dependent, and can be used to optimize application performance with a specific engine. For example, this value can be used with speaker-independent engines, allowing use of a large amount of recorded speech to correctly optimize the overall accuracy of the application.

    Use this value with care. Although it will improve the application with a particular speech engine, it may make it worse with other engines.

Requirements

Header sapi.h, sapi.idl
Windows Embedded CE Windows CE .NET 4.1 and later

See Also

Reference

SAPI Structures