MFCreateAMMediaTypeFromMFMediaType 函数 (mfapi.h)

从媒体基础媒体类型创建 DirectShow AM_MEDIA_TYPE 结构。

语法

HRESULT MFCreateAMMediaTypeFromMFMediaType(
  IMFMediaType  *pMFType,
  GUID          guidFormatBlockType,
  AM_MEDIA_TYPE **ppAMType
);

parameters

pMFType

指向要转换的媒体类型的 IMFMediaType 接口的指针。

guidFormatBlockType

格式类型 GUID。 此值对应于AM_MEDIA_TYPE结构的 formattype 成员,并指定要分配的格式块的类型。 如果值GUID_NULL,则函数会尝试根据主类型和子类型推断出正确的格式块。

ppAMType

接收指向 AM_MEDIA_TYPE 结构的指针。 调用方必须通过调用 CoTaskMemFree 释放为结构分配的内存。 该函数还为格式块分配内存,调用方必须通过在 pbFormat 成员上调用 CoTaskMemFree 来释放该内存。

返回值

函数返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
函数成功。

注解

此函数还可用于以下等效于 AM_MEDIA_TYPE 的格式结构:

  • DMO_MEDIA_TYPE (DirectX 媒体对象)
  • WM_MEDIA_TYPE (Windows Media Format SDK)

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

另请参阅

媒体基础函数

媒体类型转换

媒体类型