ISpRecognizer3::GetCategory (SAPI 5.4)

  • Article

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

Value
S_OK
E_INVALIDARG
FAILED(hr)

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."