Share via

ISpRecognizer::SetRecognizer (SAPI 5.4)

  • Article

Microsoft Speech API 5.4

ISpRecognizer::SetRecognizer

ISpRecognizer::SetRecognizer specifies the particular speech recognition engine to be used.

  
    HRESULT SetRecognizer(ISpObjectToken   *pEngineToken
);

Parameters

  • pEngineToken
    [in] The object token referring to the speech recognition engine to be used.

Return values

Value
S_OK
E_INVALIDARG
SPERR_ENGINE_BUSY
FAILED(hr)

Remarks

This method allows the application to select a particular engine object token to be used (For example, the method SpFindBestToken could be used to find an engine supporting certain attributes, and the resulting token could be passed to this method).

If this method is not called, SAPI will use the current default SR engine.

If this method is passed NULL, SAPI will switch to the current default SR engine.

This method cannot be called when the current SR engine is already running and processing audio. In addition, when using the shared recognizer, it cannot be called if another application is also using the shared recognizer.