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

  • Artículo

Recupera una representación alternativa del tipo de medio. Actualmente solo se admite la estructura de AM_MEDIA_TYPE directShow .

Sintaxis

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

Parámetros

[in] guidRepresentation

GUID que especifica la representación que se va a recuperar. Se definen los valores siguientes.

Valor Significado
AM_MEDIA_TYPE_REPRESENTATION
 Convierta el tipo de medio en una estructura de AM_MEDIA_TYPE DirectShow. El método selecciona la estructura de formato más adecuada (pbFormat).
FORMAT_MFVideoFormat
 Convierta el tipo de medio en una estructura de AM_MEDIA_TYPE DirectShow con una estructura de formato MFVIDEOFORMAT .
FORMAT_VideoInfo
 Convierta el tipo de medio en una estructura de AM_MEDIA_TYPE DirectShow con una estructura de formato VIDEOINFOHEADER .
FORMAT_VideoInfo2
 Convierta el tipo de medio en una estructura de AM_MEDIA_TYPE directShow con una estructura de formato VIDEOINFOHEADER2 .

[out] ppvRepresentation

Recibe un puntero a una estructura que contiene la representación. El método asigna la memoria para la estructura. El autor de la llamada debe liberar la memoria llamando a IMFMediaType::FreeRepresentation.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_ATTRIBUTENOTFOUND
 Los detalles del tipo de medio no coinciden con la representación solicitada.
MF_E_INVALIDMEDIATYPE
 El tipo de medio no es válido.
MF_E_UNSUPPORTED_REPRESENTATION
 El tipo de medio no admite la representación solicitada.

Comentarios

Si solicita una estructura de formato específica en el parámetro guidRepresentation , como VIDEOINFOHEADER, puede perder parte de la información de formato.

También puede usar la función MFInitAMMediaTypeFromMFMediaType para convertir un tipo de medio de Media Foundation en un tipo de medio DirectShow.

Esta interfaz está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

  • Windows XP con Service Pack 2 (SP2) y versiones posteriores.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfobjects.h (include Mfidl.h)
Library Mfuuid.lib

Consulte también

IMFMediaType

MFVIDEOFORMAT

Tipos de medios