Função MFCreateMediaTypeFromRepresentation (mfapi.h)

  • Artigo

Cria um tipo de mídia do Media Foundation com base em outra representação de formato.

Sintaxe

HRESULT MFCreateMediaTypeFromRepresentation(
  [in]  GUID         guidRepresentation,
  [in]  LPVOID       pvRepresentation,
  [out] IMFMediaType **ppIMediaType
);

Parâmetros

[in] guidRepresentation

GUID que especifica qual representação de formato converter. O valor a seguir é definido.

GUID Descrição
AM_MEDIA_TYPE_REPRESENTATION Converter uma estrutura de AM_MEDIA_TYPE do DirectShow.

[in] pvRepresentation

Ponteiro para um buffer que contém a representação de formato a ser convertida. O layout do buffer depende do valor de guidRepresentation.

[out] ppIMediaType

Recebe um ponteiro para a interface IMFMediaType . O chamador deve liberar a interface .

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.
MF_E_UNSUPPORTED_REPRESENTATION
 Não há suporte para o GUID especificado em guidRepresentation .

Comentários

Se o formato original for um tipo de mídia de áudio DirectShow e o tipo de formato não for reconhecido, a função definirá os atributos a seguir no tipo de mídia convertido.

Atributo Descrição
MF_MT_AM_FORMAT_TYPE Contém o tipo de formato GUID.
MF_MT_USER_DATA Contém o bloco de formato.

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