ISpSREngineSite::SetBufferNotifySize
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 sets the minimum amount of data that should be available before a data available event is set. The engine uses the method only if it calls ISpSREngineSite::Read with at least a certain amount of data available. The engine only calls this method from inside a call to its ISpSREngine::RecognizeStream method, but it can be called on any thread.
This method is used in conjunction with the Win32 event passed as a parameter to ISpSREngine::RecognizeStream. On non-real-time streams, for example, a stream read from a wave file, this event will always be set, as all the data in the file is available for reading. In this case, ISpSREngineSite::SetBufferNotifySize will return SP_UNSUPPORTED_ON_STREAM_INPUT.
Syntax
HRESULT SetBufferNotifySize(
ULONG cbSize
);
Parameters
- cbSize
[in] Minimum amount of data, in bytes, that should be available before the data available event is set.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
SP_UNSUPPORTED_ON_STREAM_INPUT |
Function call has no effect, as the stream is not real-time audio. |
FAILED(hr) |
Appropriate error message. |
Requirements
| Header | sapiddk.h, sapiddk.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |