Microsoft Speech Platform

ISpRecoResult::GetRecoContext

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

<pre IsFakePre="true" xmlns="http://www.w3.org/1999/xhtml"> <strong>HRESULT GetRecoContext(</strong><a runat="server" href="jj127719(v=msdn.10).md"><strong>ISpRecoContext</strong></a> **<em>ppRecoContext</em> <strong>);</strong> </pre>

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

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