Microsoft Speech Platform

SPPHRASEPROPERTY

SPPHRASEPROPERTY stores the information for one semantic property. It can be used to construct a semantic property tree.

See also Designing Grammar Rules for more information about semantic properties.

`

typedef [restricted, hidden] struct SPPHRASEPROPERTY SPPHRASEPROPERTY;


// For SRGS grammars, this enum indicates how to use the union.
typedef [hidden] enum SPPHRASEPROPERTYUNIONTYPE
{
  SPPPUT_UNUSED = 0,
  SPPPUT_ARRAY_INDEX         // The union contains usArrayIndex.
} SPPHRASEPROPERTYUNIONTYPE

struct SPPHRASEPROPERTY
{
    LPCWSTR                    *pszName;
    ULONG                       ulId;
      union
      {
        ULONG                   ulId;; // For Speech Platform grammars, indicates the property ID, if specified.
          struct
          {
            byte                bType; 
            byte                bReserved; 
            unsigned short      usArrayIndex; 
          }; 
      }; 
    LPCWSTR                    *pszValue;
    VARIANT                     vValue;
    ULONG                       ulFirstElement;
    ULONG                       ulCountOfElements;
    const  SPPHRASEPROPERTY    *pNextSibling;
    const  SPPHRASEPROPERTY    *pFirstChild;
    float                       SREngineConfidence;
    signed char                 Confidence;
};

Members

• pszName
  Name of the null-terminated string of the semantic property.
• ulId
  The identifier of the semantic property.
• bType
  SPPHRASEPROPERTYUNIONTYPE indicating how to use the union.
• bReserved
  Reserved.
• usArrayIndex
  For W3C grammars, indicates the array index, if this is an array element. Array elements have the name "item".
• pszValue
  Null-terminated string value of the semantic property.
• vValue
  VARIANT value of a semantic property. The type has to be on of the following: VT_BOOL, VT_I4, VT_R4, VT_R8, or VT_BYREF (only for dynamic grammars).
• ulFirstElement
  The first spoken element spanned by this property.
• ulCountOfElements
  The number of spoken elements spanned by this property.
• pNextSibling
  Pointer to next sibling in property tree.
• pFirstChild
  Pointer to the first child of this semantic property.
• SREngineConfidence
  Confidence value for this semantic property computed by the speech recognition (SR) engine. The value range is specific to each SR engine.
• Confidence
  Confidence value for this semantic property computed by the Speech Platform. The value is either SP_LOW_CONFIDENCE, SP_NORMAL_CONFIDENCE, or SP_HIGH_CONFIDENCE.