Microsoft Speech Platform
ISpRecognizer3::GetActiveCategory
New in Microsoft Speech Platform
ISpRecognizer3::GetActiveCategory gets the currently active recognizer category.
HRESULT GetActiveCategory(
ISpRecoCategory **ppCategory
);
Parameters
- ppCategory
- [out] A pointer to a memory location that contains the address of an ISpRecoCategory instance.
Return values
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_POINTER | The memory that ppCategory points to cannot be written to. |
| FAILED(hr) | Appropriate error message. |
Remarks
A value of NULL for **ppCategory indicates that the recognizer is in both command and dictation mode. That is, the recognizer waits for either dictation (free text) or a command such as "start Notepad."