Share via


Note

Please see Azure Cognitive Services for Speech documentation for the latest supported speech solutions.

Microsoft Speech Platform

ISpRecoContext::SetVoice

ISpRecoContext::SetVoice sets the associated ISpVoice to an object.

<pre IsFakePre="true" xmlns="http://www.w3.org/1999/xhtml"> <strong>HRESULT SetVoice(</strong><a runat="server" href="jj127823(v=msdn.10).md"><strong>ISpVoice</strong></a> *<em>pVoice</em>, <strong> BOOL</strong> <em>fAllowFormatChanges</em> <strong>);</strong> </pre>

Parameters

  • pVoice
    [in] The voice interface to be associated. If NULL, the currently associated voice is released.
  • fAllowFormatChanges
    [in] Boolean that allows alteration of the voice format by the speech recognition engine. See Remarks section.

Return Values

Value Description
S_OK Function completed successfully.
E_POINTER pVoice is not valid or bad.
FAILED(hr) Appropriate error message.

Remarks

If fAllowFormatChanges is TRUE, the voice's output format will be changed to be the same format as the associated speech recogition (SR) engine's audio input format (see ISpRecognizer). However, if this voice object has already been bound to a stream which has a specific format, the voice's format will not be changed to the SR engine's audio input format even if fAllowFormatChanges is true.

Using the same audio format for input and output source is useful for sound cards that do not support full-duplex audio (that is, the input format must match the output format). If the input format quality is lower than the output format quality, the output format quality will be reduced to equal the input quality.

After calling ISpRecoContext::SetVoice, an application that calls ISpRecoContext::GetVoice will retrieve the ISpVoice interface pointer that was originally set.