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