ISpRecoContext::GetRecognizer

Microsoft Speech SDK

The Microsoft.com Speech website Microsoft Speech SDK SAPI 5.1

ISpRecoContext::GetRecognizer

ISpRecoContext::GetRecognizer returns a reference to the current recognizer object associated with this context.

HRESULT GetRecognizer(
   ISpRecognizer   **ppRecognizer
);

Parameters

ppRecognizer
[out] Address of a pointer that receives the ISpRecognizer interface. The application must call IUnknown::Release when finished with the interface.

Return values

Value Description
S_OK Function completed successfully.
E_POINTER Invalid pointer.
FAILED (hr) Appropriate error message.

Example

The following code snippet illustrates the use of ISpRecoContext::GetRecognizer with a shared context

    HRESULT hr = S_OK;

    // create a shared recognition context
    hr = cpRecoContext.CoCreateInstance(CLSID_SpSharedRecoContext);
    // Check hr

    // get a reference to the associated recognizer
    hr = cpRecoContext->GetRecognizer(&cpRecognizer);
    // Check hr

    // assert that our shared context has a shared recognizer
    hr = cpRecognizer->IsSharedInstance();
    // Check that hr == S_OK