Microsoft Speech Platform
ISpRecognizer::GetFormat
ISpRecognizer::GetFormat retrieves the current input audio format.
HRESULT GetFormat(
SPSTREAMFORMATTYPE WaveFormatType,
GUID *pFormatId,
WAVEFORMATEX **ppCoMemWFEX
);
Parameters
- WaveFormatType
- [in] One of the wave file format types specified in SPSTREAMFORMATTYPE.
- pFormatId
- [out] The address of the unique identifier associated with the format type.
- ppCoMemWFEX
- [out] Address of a pointer to a WAVEFORMATEX structure that receives the format information. This is set only if the input is of a wave format type. The application must free this data with CoTaskMemFree after use.
Return values
Value | Description |
---|---|
S_OK | Function completed successfully. |
E_POINTER | Invalid pointer. |
SPERR_UNINITIALIZED | Audio input not yet set. |
FAILED(hr) | Appropriate error message. |
Remarks
This method can return either the input format or the engine format. Normally these two values will be the same, but if SAPI is using a format converter to convert the input data from the audio input to the engine format these will be different.