MFCreateMediaEvent

Creates a media event object.

Syntax

HRESULT MFCreateMediaEvent(
         MediaEventType met,
         REFGUID guidExtendedType,
         HRESULT hrStatus,
         const PROPVARIANT *pvValue,
         IMFMediaEvent **ppEvent
)  

Parameters

met
Type: MediaEventType 

[in]

The event type. See IMFMediaEvent::GetType. For a list of event types, see Media Foundation Events.

guidExtendedType
Type: REFGUID 

[in]

The extended type. See IMFMediaEvent::GetExtendedType. If the event type does not have an extended type, use the value GUID_NULL.

hrStatus
Type: HRESULT 

[in]

The event status. See IMFMediaEvent::GetStatus

pvValue
Type: PROPVARIANT *

[in, optional]

The value associated with the event, if any. See IMFMediaEvent::GetValue. This parameter can be NULL.

ppEvent
Type: IMFMediaEvent **

[out]

Receives a pointer to the IMFMediaEvent interface. The caller must release the interface.

Return value

Type: HRESULT 

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return codes
Return code Description
S_OK The method succeeded.

Refer to Media Foundation return codes.

Remarks

Requirements

Header: Declared in mfapi.h.

Library: Use Mfplat.lib.