ISpNotifySource (SAPI 5.4)

Microsoft Speech API 5.4

ISpNotifySource

In both speech synthesis and speech recognition, applications receive notifications when words have been spoken or when phrases have been recognized. SAPI components that generate notifications implement an ISpNotifySource.

The ISpNotifySource and ISpNotifySink interfaces alone only provide a mechanism for a notification but no information on the events that caused the notification. With an ISpEventSource object, an application can retrieve information about the events that caused the notification.

Applications will not typically use the free-threaded ISpNotifySink mechanism for receiving SAPI event notifications. They will use one of the simplified methods of either a window message, callback or Win32 event.

Note that both variations of callbacks as well as the window message notification require a window message pump to run on the thread that initialized the notification source. Callback will only be called as the result of window message processing, and will always be called on the same thread that initialized the notify source. However, using Win32 events for SAPI event notification does not require a window message pump.

Implemented By

• SpRecoContext
• SpSharedRecoContext
• SpVoice
• SpMMAudioIn
• SpMMAudioOut
• SpRecPlayAudio
• SpStreamFormatConverter

Methods in Vtable Order

ISpNotifySource Methods

SetNotifySink

SetNotifyWindowMessage

SetNotifyCallbackFunction

SetNotifyCallbackInterface

SetNotifyWin32Event

WaitForNotifyEvent

GetNotifyEventHandle