Export (0) Print
Expand All

ISpRecognizer::SetRecoProfile (SAPI 5.4)

Speech API 5.4
Microsoft Speech API 5.4

ISpRecognizer::SetRecoProfile

ISpRecognizer::SetRecoProfile sets the recognition profile to be used by the recognizer.

HRESULT SetRecoProfile(
   ISpObjectToken   *pToken
);

Parameters

pToken
[in] Address of an ISpObjectToken object that contains the profile information.

Return values

ValueDescription
S_OKFunction completed successfully.
E_INVALIDARGOne or more parameters are invalid.
FAILED(hr)Appropriate error message.

Remarks

A recognition profile represents a single user and training sessions on the system. The user can create, delete, and set the current profile using Speech properties in Control Panel. SAPI will always create the engine using the current default profile. This method can be used to set the SR engine to use a profile other than the default.

This method should not be called when the engine is currently processing audio. Calling ::SetRecoProfile with an active recognition engine can cause unexpected results, depending on how and when the SR engine reads the profile information.

Show:
© 2014 Microsoft