Microsoft Speech Platform
ISpRecognizer3::SetActiveCategory
New in Microsoft Speech Platform
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 | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_INVALIDARG | pCategory 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."