Export (0) Print
Expand All

ISpNotifySource::SetNotifySink (SAPI 5.4)

Speech API 5.4
Microsoft Speech API 5.4

ISpNotifySource::SetNotifySink

ISpNotifySource::SetNotifySink sets up the instance to make free-threaded notification calls through ISpNotifySink::Notify.

HRESULT SetNotifySink(
   ISpNotifySink  *pNotifySink
);

Parameters

pNotifySink
[in] Pointer to the notification interface. If pNotifySink is NULL, any current notification mechanism (notify sink, window message, callback, or Win32 event) is removed.

Return values

ValueDescription
S_OKFunction completed successfully.
E_INVALIDARGInterface pointer is invalid.
FAILED (hr)Appropriate error message.

Remarks

If pNotifySink is NULL, any notification mechanism currently associated with this notify source is removed.

Because free-threaded notifications can occur on any thread, at any point during execution, they are extremely prone to deadlocks and re-entrance problems. See the documentation for ISpNotifySink for more details. Most applications will find one of the other notification mechanisms much easier to use.

Show:
© 2014 Microsoft