IMediaEventSink Interface

The filter graph manager exposes the IMediaEventSink interface; it is called from filters to notify events. Applications use the IMediaEvent interface on the filter graph manager to retrieve these events.

When to Implement

There is no need to implement this method because it is implemented by the filter graph manager.

When to Use

Filters use this interface to post event notifications.

Methods in Vtable Order

IUnknown methods	Description
QueryInterface	Returns pointers to supported interfaces.
AddRef	Increments the reference count.
Release	Decrements the reference count.

IMediaEventSink methods	Description
Notify	Notifies an event.

---

IMediaEventSink::Notify

IMediaEventSink Interface

Notifies an event.

HRESULT Notify(
  long EventCode,
  long EventParam1,
  long EventParam2
  );

Parameters

EventCode

[in] Identifier of the event.

EventParam1

[in] First event parameter.

EventParam2

[in] Second event parameter.

Return Values

Returns an HRESULT value that depends on the implementation. HRESULT can be one of the following standard constants, or other values not listed:

Value	Meaning
E_FAIL	Failure.
E_POINTER	Null pointer argument.
E_INVALIDARG	Invalid argument.
E_NOTIMPL	Method isn't supported.
S_OK or NOERROR	Success.

Remarks

The event is queued but not delivered to the application on this thread. For a list of notification codes and event parameter values, see Event Notification Codes.

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.

Top of Page