Método IMFMediaType::GetRepresentation (mfobjects.h)

  • Artigo

Recupera uma representação alternativa do tipo de mídia. Atualmente, há suporte apenas para a estrutura AM_MEDIA_TYPE do DirectShow.

Sintaxe

HRESULT GetRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation
);

Parâmetros

[in] guidRepresentation

GUID que especifica a representação a ser recuperada. Os valores a seguir são definidos.

Valor Significado
AM_MEDIA_TYPE_REPRESENTATION
 Converta o tipo de mídia em uma estrutura de AM_MEDIA_TYPE do DirectShow. O método seleciona a estrutura de formato mais apropriada (pbFormat).
FORMAT_MFVideoFormat
 Converta o tipo de mídia em uma estrutura de AM_MEDIA_TYPE do DirectShow com uma estrutura de formato MFVIDEOFORMAT .
FORMAT_VideoInfo
 Converta o tipo de mídia em uma estrutura de AM_MEDIA_TYPE do DirectShow com uma estrutura de formato VIDEOINFOHEADER .
FORMAT_VideoInfo2
 Converta o tipo de mídia em uma estrutura de AM_MEDIA_TYPE do DirectShow com uma estrutura de formato VIDEOINFOHEADER2 .

[out] ppvRepresentation

Recebe um ponteiro para uma estrutura que contém a representação. O método aloca a memória para a estrutura. O chamador deve liberar a memória chamando IMFMediaType::FreeRepresentation.

Retornar valor

O método 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
 O método foi bem-sucedido.
MF_E_ATTRIBUTENOTFOUND
 Os detalhes do tipo de mídia não correspondem à representação solicitada.
MF_E_INVALIDMEDIATYPE
 O tipo de mídia não é válido.
MF_E_UNSUPPORTED_REPRESENTATION
 O tipo de mídia não dá suporte à representação solicitada.

Comentários

Se você solicitar uma estrutura de formato específica no parâmetro guidRepresentation , como VIDEOINFOHEADER, poderá perder algumas das informações de formato.

Você também pode usar a função MFInitAMMediaTypeFromMFMediaType para converter um tipo de mídia do Media Foundation em um tipo de mídia DirectShow.

Essa interface estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfobjects.h (inclua Mfidl.h)
Biblioteca Mfuuid.lib

Confira também

IMFMediaType

MFVIDEOFORMAT

Tipos de mídia