ISpRecoResult::GetRecoContext (Microsoft Speech Platform)

Microsoft Speech Platform SDK 11

Microsoft Speech Platform

ISpRecoResult::GetRecoContext

ISpRecoResult::GetRecoContext returns the recognition context object that is associated with this result.

HRESULT GetRecoContext(
   ISpRecoContext   **ppRecoContext
);

Parameters

ppRecoContext
[out] A pointer that receives the recognition context interface pointer. The caller must call ::Release on the ISpRecoContext references when it is finished.

Return values

Value Description
S_OK Function completed successfully.
E_POINTER ppRecoContext is invalid or bad.
FAILED(hr) Appropriate error message.

Example

The following code snippet illustrates the use of ISpRecoResult::GetRecoContext to retrieve a reference to the ISpRecoContext instance that is associated with a recognized phrase and determine the maximum number of CFG alternates that can be generated for it.


// Declare local identifiers:
HRESULT                       hr = S_OK;
CComPtr<ISpRecoContext>       cpRecoContext;
CComPtr<ISpRecoResult>        cpRecoResult;
DWORD                         dwMaxAlternates;

// ... Obtain a recognition result object from the recognizer ...

// Get the associated ISpRecoContext.
hr = cpRecoResult->GetRecoContext(&cpRecoContext;);

if (SUCCEEDED(hr))
{
   // Get maximum number of CFG alternates.
   hr = cpRecoContext->GetMaxAlternates(&dwMaxAlternates;);
}

if (SUCCEEDED(hr))
{
   // Do stuff here.
}