ISpSREngine::PrivateCallEx
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method handles an engine extension call to the SR engine. It behaves the same way as ISpSREngine::PrivateCall, except that it allows the engine to retrieve a data block of variable size for the engine extension object.
Syntax
HRESULT PrivateCallEx(
void* pvEngineContext,
const void* pInCallFrame,
ULONG ulInCallFrameSize,
void** ppvCoMemResponse,
ULONG* pulResponseSize
);
Parameters
- pvEngineContext
[in] Pointer to the speech recognition context for the engine. The pointer is retrieved by a prior call to the ISpSREngine::OnCreateRecoContext method.
- pInCallFrame
[in] Pointer to engine-specific input data.
- ulInCallFrameSize
[in] Size, in bytes, of the engine-specific data specified by pInCallFrame.
- ppvCoMemResponse
[out] Address of a pointer to the response block information from the SR engine. This must be allocated with CoTaskMemAlloc.
- pulResponseSize
[out] Pointer to the size, in bytes, of the data specified by ppvCoMemResponse.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
FAILED(hr) |
Appropriate error message. |
Requirements
| Header | sapiddk.h, sapiddk.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |