ISpSREngineSite::SetBufferNotifySize (SAPI 5.3)

Speech API 5.3
Microsoft Speech API 5.3


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


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

Return values

S_OKFunction completed successfully.
SP_UNSUPPORTED_ON_STREAM_INPUTFunction call has no effect as this is a non-real time audio stream.
FAILED(hr)Other appropriate error message.


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.