ISpRecognizer3::GetCategory (SAPI 5.4)

Speech API 5.4
Microsoft Speech API 5.4

ISpRecognizer3::SetActiveCategory

New in SAPI 5.4

ISpRecognizer3::SetActiveCategory sets the active recognizer category to the specified category.


HRESULT SetActiveCategory(
      ISpRecoCategory   *pCategory   
);

Parameters

pCategory
[in] A pointer to an ISpRecoCategory instance.

Return values

ValueDescription
S_OKFunction completed successfully.
E_INVALIDARGpCategory is invalid.
FAILED(hr)Appropriate error message.

Remarks

Passing a value of NULL for *pCategory places the recognizer in a mode such that it waits for either command or dictation. That is, the recognizer waits for either dictation (free text) or a command such as "start Notepad."

Show: