共用方式為

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 2005。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfobjects.h (包含 Mfidl.h)
程式庫 Mfuuid.lib

另請參閱

IMFMediaEventQueue