ISpSREngineSite::SetBufferNotifySize

Microsoft Speech SDK

The Microsoft.com Speech website Microsoft Speech SDK SAPI 5.1

ISpSREngineSite::SetBufferNotifySize

ISpSREngineSite::SetBufferNotifySize

controls how much data will be available to read before this event gets set. This method is used in conjunction with the hDataAvailable Win32 event that is passed as a parameter in ISpSREngine::RecognizeStream.
HRESULT SetBufferNotifySize(
   ULONG   cbSize
);

Parameters

cbSize
[in] The minimum amount of data that should be available before the data available event is set.

Return values

Value Description
S_OK Function completed successfully.
SP_UNSUPPORTED_ON_STREAM_INPUT Function call has no effect as this is a non-real time audio stream.
FAILED(hr) Other appropriate error message.

Remarks

This can be used if an engine calls Read only when at least a certain amount of data is available. 

On non-real time streams, for example when reading from a wave file, this event will always be set, as all the data in the file is always available for reading. This method will return SP_UNSUPPORTED_ON_STREAM_INPUT in this case.

This method can only be called while the SR engine is inside a ISpSREngine::RecognizeStream call, although it can be called on any thread.