ISpEventSource

Microsoft Speech SDK

The Microsoft.com Speech website Microsoft Speech SDK SAPI 5.1

ISpEventSource

The ISpEventSource inherits from the ISpNotifySource interface.  Using the methods on ISpNotifySource an application can specify the mechanism by which they receive notifications.  Applications can configure which events should trigger notifications and which events retrieve queued events.

An ISpEventSource provides the mechanism to filter and queue events. By default, an application (really an ISpNotifySink) receives no notifications from the SpVoice object, until SetInterest has been called to specify on which events to notify or queue.  For the SpRecoContext object, the default event interest is set to queue only recognition events.

When an application is notified of an event that is not queued, it will proceed based on which event sink receives the notification. From context, an application might know exactly what it needs to do, or it may need to interact with the components that sent the notifications. If an application is notified of a queued event, the application will call ISpEventSource::GetEvents to retrieve the actual events that caused a notification.

Implemented By

Methods in Vtable Order

ISpEventSource Methods Description
ISpNotifySource inherited methods All methods of ISpNotifySource are accessible from this interface
SetInterest Sets the type of events the client is interested in.
GetEvents Retrieves and removes the queued events.
GetInfo Retrieves information about the event queue.