ISpRecognizer3::GetActiveCategory (SAPI 5.4)
New in SAPI 5.4
ISpRecognizer3::GetActiveCategory gets the currently active recognizer category.
HRESULT GetActiveCategory( ISpRecoCategory **ppCategory );
- [out] A pointer to a memory location that contains the address of an ISpRecoCategory instance.
|S_OK||Function completed successfully.|
|E_POINTER||The memory that ppCategory points to cannot be written to.||FAILED(hr)||Appropriate error message.|
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."