ISpSREngineSite::SetBufferNotifySize (SAPI 5.3)

  • Article

Microsoft Speech API 5.3

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
S_OK
SP_UNSUPPORTED_ON_STREAM_INPUT
FAILED(hr)

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.