Platform SDK: TAPI

ITCallMediaEvent::get_Event

Gets the call media event indicator.

HRESULT get_Event(
  CALL_MEDIA_EVENT *pCallMediaEvent
);

Parameters

pCallMediaEvent
[out, retval] Pointer to CALL_MEDIA_EVENT indicator.

Return Values

Value Meaning
S_OK Method succeeded.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
E_POINTER The pCallMediaEvent parameter is not a valid pointer.

Remarks

Call media events are a crucial indicator of whether certain operations can be performed. For example, when IVideoWindow is exposed on the Terminal object, until the CME_STREAM_ACTIVE is received only the put_Visible method will succeed.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITCallMediaEvent, Call Object, CALL_MEDIA_EVENT