Função MFCreateAMMediaTypeFromMFMediaType (mfapi.h)

Cria uma estrutura AM_MEDIA_TYPE DirectShow de um tipo de mídia do Media Foundation.

Sintaxe

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

Parâmetros

pMFType

Ponteiro para a interface IMFMediaType do tipo de mídia a ser convertido.

guidFormatBlockType

Tipo de formato GUID. Esse valor corresponde ao membro formattype da estrutura AM_MEDIA_TYPE e especifica o tipo de bloco de formato a ser alocado. Se o valor for GUID_NULL, a função tentará deduzir o bloco de formato correto, com base no tipo e subtipo principais.

ppAMType

Recebe um ponteiro para uma estrutura AM_MEDIA_TYPE . O chamador deve liberar a memória alocada para a estrutura chamando CoTaskMemFree. A função também aloca memória para o bloco de formato, que o chamador deve liberar chamando CoTaskMemFree no membro pbFormat .

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	A função foi bem-sucedida.

Comentários

Essa função também pode ser usada com as seguintes estruturas de formato equivalentes a AM_MEDIA_TYPE:

• DMO_MEDIA_TYPE (Objetos de Mídia DirectX)
• WM_MEDIA_TYPE (SDK de Formato de Mídia do Windows)

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfapi.h
Biblioteca	Mfplat.lib
DLL	Mfplat.dll

Confira também

Funções do Media Foundation

Conversões de tipo de mídia

Tipos de mídia