MFInitAMMediaTypeFromMFMediaType 函式 (mfapi.h)

從媒體基礎媒體類型初始化 DirectShow AM_MEDIA_TYPE 結構。

語法

HRESULT MFInitAMMediaTypeFromMFMediaType(
  IMFMediaType  *pMFType,
  GUID          guidFormatBlockType,
  AM_MEDIA_TYPE *pAMType
);

參數

pMFType

要轉換之媒體類型的 IMFMediaType 介面指標。

guidFormatBlockType

格式類型 GUID。 這個值會對應至AM_MEDIA_TYPE結構的formattype成員，並指定要配置的格式區塊類型。 如果值GUID_Null，函式會嘗試根據主要類型和子類型來推斷正確的格式區塊。

pAMType

AM_MEDIA_TYPE結構的指標。 函式會配置格式區塊的記憶體。 呼叫端必須在pbFormat成員上呼叫CoTaskMemFree來釋放格式區塊。

傳回值

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

傳回碼	描述
S_OK	此函數已成功。
MF_E_INVALIDMEDIATYPE	媒體類型無效。

備註

此函式也可以搭配下列相當於 AM_MEDIA_TYPE的格式結構使用：

• DMO_MEDIA_TYPE (DirectX 媒體物件)
• WM_MEDIA_TYPE (Windows Media Format SDK)

需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	mfapi.h
程式庫	Mfplat.lib
Dll	Mfplat.dll

另請參閱

媒體基礎函式