IMFMediaTypeHandler：：SetCurrentMediaType 方法 (mfidl.h)

  • 發行項

設定物件的媒體類型。

語法

HRESULT SetCurrentMediaType(
  [in] IMFMediaType *pMediaType
);

參數

[in] pMediaType

新媒體類型的 IMFMediaType 介面指標。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。
MF_E_INVALIDREQUEST
 無效的要求

備註

針對媒體來源，設定媒體類型表示來源會產生符合該媒體類型的資料。 針對媒體接收，設定媒體類型表示接收可以接收符合該媒體類型的資料。

這個方法的任何實作都應該檢查 pMediaType 是否與物件的目前媒體類型不同。 如果類型相同，方法應該會傳回S_OK，但避免不必要地釋放和重新建立資源。 如果型別不相同，方法應該驗證新的類型。

如果已安裝 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
標頭 mfidl.h
程式庫 Mfuuid.lib

另請參閱

IMFMediaTypeHandler