SPSTREAMFORMAT

  • Article

This enumeration defines stream formats. It represents all common audio formats, from uncompressed PCM formats to more highly compressed formats. These formats are available as standard on the Windows operating systems on which SAPI 5.0 is designed to run.

This enumeration can be used with the helper function SpConvertStreamFormatEnum and the helper class CSpStreamFormat. These helpers allow the developer to avoid creating a WAVEFORMATEX structure by hand, which can introduce subtle errors introduced by typographical errors.

typedef enum SPSTREAMFORMAT{
  SPSF_Default = -1,
  SPSF_NoAssignedFormat = 0,
  SPSF_Text,
  SPSF_NonStandardFormat,
  SPSF_ExtendedAudioFormat,
  // Standard PCM wave formats
  SPSF_8kHz8BitMono,
  SPSF_8kHz8BitStereo,
  SPSF_8kHz16BitMono,
  SPSF_8kHz16BitStereo,
  SPSF_11kHz8BitMono,
  SPSF_11kHz8BitStereo,
  SPSF_11kHz16BitMono,
  SPSF_11kHz16BitStereo,
  SPSF_12kHz8BitMono,
  SPSF_12kHz8BitStereo,
  SPSF_12kHz16BitMono,
  SPSF_12kHz16BitStereo,
  SPSF_16kHz8BitMono,
  SPSF_16kHz8BitStereo,
  SPSF_16kHz16BitMono,
  SPSF_16kHz16BitStereo,
  SPSF_22kHz8BitMono,
  SPSF_22kHz8BitStereo,
  SPSF_22kHz16BitMono,
  SPSF_22kHz16BitStereo,
  SPSF_24kHz8BitMono,
  SPSF_24kHz8BitStereo,
  SPSF_24kHz16BitMono,
  SPSF_24kHz16BitStereo,
  SPSF_32kHz8BitMono,
  SPSF_32kHz8BitStereo,
  SPSF_32kHz16BitMono,
  SPSF_32kHz16BitStereo,
  SPSF_44kHz8BitMono,
  SPSF_44kHz8BitStereo,
  SPSF_44kHz16BitMono,
  SPSF_44kHz16BitStereo,
  SPSF_48kHz8BitMono,
  SPSF_48kHz8BitStereo,
  SPSF_48kHz16BitMono,
  SPSF_48kHz16BitStereo,
  // TrueSpeech format
  SPSF_TrueSpeech_8kHz1BitMono,
  // A-Law formats
  SPSF_CCITT_ALaw_8kHzMono,
  SPSF_CCITT_ALaw_8kHzStereo,
  SPSF_CCITT_ALaw_11kHzMono,
  SPSF_CCITT_ALaw_11kHzStereo,
  SPSF_CCITT_ALaw_22kHzMono,
  SPSF_CCITT_ALaw_22kHzStereo,
  SPSF_CCITT_ALaw_44kHzMono,
  SPSF_CCITT_ALaw_44kHzStereo,
  // u-Law formats
  SPSF_CCITT_uLaw_8kHzMono,
  SPSF_CCITT_uLaw_8kHzStereo,
  SPSF_CCITT_uLaw_11kHzMono,
  SPSF_CCITT_uLaw_11kHzStereo,
  SPSF_CCITT_uLaw_22kHzMono,
  SPSF_CCITT_uLaw_22kHzStereo,
  SPSF_CCITT_uLaw_44kHzMono,
  SPSF_CCITT_uLaw_44kHzStereo,
  // ADPCM formats
  SPSF_ADPCM_8kHzMono,
  SPSF_ADPCM_8kHzStereo,
  SPSF_ADPCM_11kHzMono,
  SPSF_ADPCM_11kHzStereo,
  SPSF_ADPCM_22kHzMono,
  SPSF_ADPCM_22kHzStereo,
  SPSF_ADPCM_44kHzMono,
  SPSF_ADPCM_44kHzStereo,
  // GSM 6.10 formats
  SPSF_GSM610_8kHzMono,
  SPSF_GSM610_11kHzMono,
  SPSF_GSM610_22kHzMono,
  SPSF_GSM610_44kHzMono,
  SPSF_NUM_FORMATS
} SPSTREAMFORMAT;

Elements

  • SPSF_Default
    Default stream format.
  • SPSF_NoAssignedFormat
    No format assigned to the stream. This format is similar to that represented by GUID_NULL.
  • SPSF_Text
    Text format.
  • SPSF_NonStandardFormat
    Non-SAPI 5.0 standard format with no WAVEFORMATEX description.
  • SPSF_ExtendedAudioFormat
    Non-SAPI 5.0 standard format but has WAVEFORMATEX description
  • SPSF_8kHz8BitMono through SPSF_48kHz16BitStereo
    Standard uncompressed PCM wave formats.
  • SPSF_TrueSpeech_8kHz1BitMono
    TrueSpeech format.
  • SPSF_CCITT_ALaw_8kHzMono through SPSF_CCITT_ALaw_44kHzStereo
    A-Law formats.
  • SPSF_CCITT_uLaw_8kHzMono through SPSF_CCITT_uLaw_44kHzStereo,
    U-Law formats.
  • SPSF_ADPCM_8kHzMono through SPSF_ADPCM_44kHzStereo
    ADPCM formats.
  • SPSF_GSM610_8kHzMono through SPSF_GSM610_44kHzMono
    GSM 6.10 formats.
  • SPSF_NUM_FORMATS
    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.