MFCreateAMMediaTypeFromMFMediaType 函式 (mfapi.h)
從媒體基礎媒體類型建立 DirectShow AM_MEDIA_TYPE 結構。
語法
HRESULT MFCreateAMMediaTypeFromMFMediaType(
IMFMediaType *pMFType,
GUID guidFormatBlockType,
AM_MEDIA_TYPE **ppAMType
);
參數
pMFType
要轉換之媒體類型的 IMFMediaType 介面指標。
guidFormatBlockType
格式類型 GUID。 這個值會對應至AM_MEDIA_TYPE結構的formattype成員，並指定要配置的格式區塊類型。 如果值GUID_Null，函式會嘗試根據主要類型和子類型推算正確的格式區塊。
ppAMType
接收 AM_MEDIA_TYPE 結構的指標。 呼叫端必須藉由呼叫 CoTaskMemFree釋放為結構配置的記憶體。 函式也會為格式區塊配置記憶體，呼叫端必須在pbFormat成員上呼叫CoTaskMemFree來釋放該區塊。
傳回值
函式會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | 描述 |
|---|---|
|
此函數已成功。 |
備註
此函式也可以搭配下列相當於 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 |