Microsoft Speech SDK
SAPI 5.1
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.
HRESULT hr = S_OK;
DWORD dwMaxAlternates;
// ... obtain a recognition result object from the recognizer...
// get the associated ISpRecoContext
hr = cpRecoResult->GetRecoContext(&cpRecoContext);
// Check hr
hr = cpRecoContext->GetMaxAlternates(&dwMaxAlternates);
// Check hr