Microsoft Speech Platform

ISpEventSource::GetEvents

ISpEventSource::GetEvents retrieves and removes queued events. Applications will want to use the helper class CSpEvent to retrieve and manipulate these events.

<pre IsFakePre="true" xmlns="http://www.w3.org/1999/xhtml"> <strong>HRESULT GetEvents(</strong> <strong> ULONG</strong> <em>ulCount</em>, <strong> SPEVENT</strong> <em>*pEventArray</em>, <strong> ULONG</strong> <em>*pulFetched</em> <strong>);</strong> </pre>

Parameters

• ulCount
  [in] Maximum number of events that SPEVENT structures can return.

• pEventArray
  [out] Pointer to array of SPEVENT structures. Each returned event is written to one of these SPEVENT structures.

• pulFetched
  [out] Pointer to the number of events returned. If ulCount is one, this parameter is not required.

  The events are then removed from the queue. The events not returned are left for a future call to GetEvents. It is possible that by the time an application calls GetEvents, another thread has processed the events and there are no events to be returned. This may be the result of subsequent Notify calls.

Return Values