Share via

ISpStreamFormatConverter::SetFormat (SAPI 5.3)

  • Article

Microsoft Speech API 5.3

ISpStreamFormatConverter::SetFormat

ISpStreamFormatConverter::SetFormat sets the output format of the converter. 

The ISpStreamFormat::GetFormat method returns the format of the output (converted) stream.

  
    HRESULT SetFormat(
   REFGUID               rguidFormatIdOfConvertedStream,
   const WAVEFORMATEX   *pWaveFormatExOfConvertedStream
);

Parameters

  • rguidFormatIdOfConvertedStream
    [in] Address of the data format identifier associated with the requested output stream. Can be GUID_NULL or SPDFID_WaveFormatEx.
  • pWaveFormatExOfConvertedStream
    [in] Address of the WAVEFORMATEX structure containing the wave file format information of the converted stream. Must be NULL with GUID_NULL. Must be a valid WAVEFORMATEX with SPDFID_WaveFormatEx.

Return values

Value
S_OK
E_INVALIDARG

Remarks

The helper class CSpStreamFormat and the SPSTREAMFORMAT enumeration can be used to avoid the possibility of typos or mistakes when filling in the WAVEFORMATEX structure.