ISpNotifyTranslator::InitWin32Event (Microsoft Speech Platform)

Microsoft Speech Platform SDK 11

Microsoft Speech Platform

ISpNotifyTranslator::InitWin32Event

ISpNotifyTranslator::InitWin32Event sets up a Win32 event object to be used by this instance.

HRESULT InitWin32Event(
    HANDLE   hEvent,
    BOOL     fCloseHandleOnRelease
);

Parameters

hEvent
Handle of an existing Win32 event object for the application to use with ISpNotifyTranslator. If this parameter is NULL, a new event will be created.
fCloseHandleOnRelease
Specifies whether the hEvent handle should be closed when the object is released. If hEvent is NULL, this parameter is ignored and the handle will always be closed upon release of the object.

Return values

Value Description
S_OK Function completed successfully.
SPERR_ALREADY_INITIALIZED Interface is already initialized.
FAILED(hr) Appropriate error message.

Remarks

The translator will call the Win32 method ::SetEvent() whenever the translator's Notify() method is called.

Initialize an event object for this instance, and then use either the WaitForNotifyEvent or GetNotfyEventHandle method. Win32 event objects and SAPI events are different. This method is similar to ISpNotifySource::SetNotifyWin32Event.