MFCreateMediaEvent 函式 (mfapi.h)
建立媒體事件物件。
語法
HRESULT MFCreateMediaEvent(
MediaEventType met,
REFGUID guidExtendedType,
HRESULT hrStatus,
const PROPVARIANT *pvValue,
IMFMediaEvent **ppEvent
);
參數
met
事件類型。 請參閱 IMFMediaEvent::GetType。 如需事件種類的清單,請參閱 媒體基礎事件。
guidExtendedType
擴充型別。 請參閱 IMFMediaEvent::GetExtendedType。 如果事件種類沒有擴充類型,請使用值GUID_Null。
hrStatus
事件狀態。 請參閱 IMFMediaEvent::GetStatus
pvValue
與事件相關聯的值,如果有的話。 請參閱 IMFMediaEvent::GetValue。 此參數可以是 Null。
ppEvent
接收 IMFMediaEvent 介面的指標。 呼叫端必須釋放 介面。
傳回值
函式會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
備註
如果已安裝 Windows Media Format 11 SDK 可轉散發元件,此函式可在下列平臺上使用:
- Windows XP with Service Pack 2 (SP2) 和更新版本。
- 已安裝 Windows XP Media Center 版本 2005 200325 (Windows XP Media Center Edition 2005) 和 KB925766 (2006 年 10 月 Windows XP Media Center Edition 更新彙總套件) 。
需求
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | mfapi.h |
程式庫 | Mfplat.lib |
Dll | Mfplat.dll |