IMFMediaEventQueue：：QueueEventParamVar 方法 (mfobjects.h)

  • 项目

创建事件，将 PROPVARIANT 设置为事件数据，并将事件放入队列中。

在 IMFMediaEventGenerator：：QueueEvent 的实现中调用此方法。 将参数从该方法直接传递给此方法。

当组件需要引发不包含属性的事件时，还可以调用此方法。 如果事件数据是 IUnknown 指针，则可以使用 IMFMediaEventQueue：：QueueEventParamUnk。 如果事件包含属性，请改用 IMFMediaEventQueue：：QueueEvent 。

语法

HRESULT QueueEventParamVar(
  [in] MediaEventType    met,
  [in] REFGUID           guidExtendedType,
  [in] HRESULT           hrStatus,
  [in] const PROPVARIANT *pvValue
);

参数

[in] met

指定要添加到队列的事件的类型。 事件类型由事件的 IMFMediaEvent：：GetType 方法返回。 有关事件类型的列表，请参阅 媒体基础事件。

[in] guidExtendedType

事件的扩展类型。 如果事件没有扩展类型，请使用值GUID_NULL。 扩展类型由事件的 IMFMediaEvent：：GetExtendedType 方法返回。

[in] hrStatus

指示事件状态的成功或失败代码。 此值由事件的 IMFMediaEvent：：GetStatus 方法返回。

[in] pvValue

指向包含事件值的 PROPVARIANT 的指针。 此参数可以为 NULL。 此值由事件的 IMFMediaEvent：：GetValue 方法返回。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 方法成功。
MF_E_SHUTDOWN
 调用了 Shutdown 方法。

注解

如果安装了 Windows Media Format 11 SDK 可再发行组件，则此接口在以下平台上可用：

  • Windows XP with Service Pack 2 (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
标头 mfobjects.h (包括 Mfidl.h)
Library Mfuuid.lib

另请参阅

IMFMediaEventQueue