IMFMediaTypeHandler::GetMediaTypeByIndex 方法 (mfidl.h)

從物件的支援媒體類型清單中擷取媒體類型。

語法

HRESULT GetMediaTypeByIndex(
  [in]  DWORD        dwIndex,
  [out] IMFMediaType **ppType
);

參數

[in] dwIndex

要擷取之媒體類型的以零起始的索引。 若要取得清單中的媒體類型數目,請呼叫 IMFMediaTypeHandler::GetMediaTypeCount

[out] ppType

接收 IMFMediaType 介面的指標。 呼叫端必須釋放 介面。

傳回值

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

傳回碼 描述
S_OK
此方法已成功。
MF_E_NO_MORE_TYPES
dwIndex參數超出範圍。

備註

媒體類型會以喜好設定的近似順序傳回。 不支援的類型清單不保證完成。 若要測試是否支援特定媒體類型,請呼叫 IMFMediaTypeHandler::IsMediaTypeSupported

如果已安裝 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