MFCreateMediaEvent 函数 (mfapi.h)

创建媒体事件对象。

语法

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

parameters

met

事件类型。 请参阅 IMFMediaEvent::GetType。 有关事件类型的列表,请参阅 媒体基础事件

guidExtendedType

扩展类型。 请参阅 IMFMediaEvent::GetExtendedType。 如果事件类型没有扩展类型,请使用 值GUID_NULL。

hrStatus

事件状态。 请参阅 IMFMediaEvent::GetStatus

pvValue

与事件关联的值(如果有)。 请参阅 IMFMediaEvent::GetValue。 此参数可以为 NULL。

ppEvent

接收指向 IMFMediaEvent 接口的指针。 调用方必须释放接口。

返回值

函数返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。

注解

如果安装了 Windows Media Format 11 SDK 可再发行组件,则此函数在以下平台上可用:

  • 具有 Service Pack 2 的 Windows XP (SP2) 及更高版本。
  • Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) 和安装KB925766 (2006 年 10 月更新汇总的 Windows XP Media Center Edition) 。

要求

   
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

另请参阅

IMFMediaEvent

媒体基础函数