ISpNotifyTranslator (Windows CE 5.0)
This interface converts a call to the ISpNotifySink::Notify method into the appropriate notification. The interface must be initialized before the ISpNotifySource::SetNotifySink method can be called, passing the translator object interface as the parameter.
Because ISpNotifySource supports most of the functionality of this interface, application writers will typically never need to use this interface. In fact, SAPI uses this interface to implement the various methods of ISpNotifySource. The method InitWin32Event supports the ability to initialize the translator with a specific event object, and so could be used for that purpose.
When to Implement
The only entity that implements this interface is SpNotifyTranslator.
Methods
The following table shows the methods for the ISpNotifyTranslator interface.
| Methods | Description |
|---|---|
| GetEventHandle | Gets the Win32 event handle associated with the translator. |
| InitCallback | Sets up this instance to send notifications using a standard C-style callback function. |
| InitSpNotifyCallback | Enables an object derived from ISpNotifyCallback to receive notifications. |
| InitWindowMessage | Sets up the instance to send window messages to a specified window. |
| InitWin32Event | Sets up a Win32 event object to be used by this instance. |
| Wait | A blocking call that waits for a notification. |
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.
Link Library: Sapilib.lib.
See Also
Send Feedback on this topic to the authors