Поделиться через

Метод IMFMediaType::GetRepresentation (mfobjects.h)

  • Статья

Извлекает альтернативное представление типа носителя. В настоящее время поддерживается только структура DirectShow AM_MEDIA_TYPE .

Синтаксис

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

Параметры

[in] guidRepresentation

GUID, задающий извлекаемого представления. Определены следующие значения.

Значение Значение
AM_MEDIA_TYPE_REPRESENTATION
 Преобразование типа мультимедиа в структуру DirectShow AM_MEDIA_TYPE . Метод выбирает наиболее подходящую структуру формата (pbFormat).
FORMAT_MFVideoFormat
 Преобразуйте тип мультимедиа в структуру DirectShow AM_MEDIA_TYPE со структурой формата MFVIDEOFORMAT .
FORMAT_VideoInfo
 Преобразуйте тип мультимедиа в структуру DirectShow AM_MEDIA_TYPE со структурой формата VIDEOINFOHEADER .
FORMAT_VideoInfo2
 Преобразуйте тип мультимедиа в структуру DirectShow AM_MEDIA_TYPE со структурой формата VIDEOINFOHEADER2 .

[out] ppvRepresentation

Получает указатель на структуру, содержащую представление. Метод выделяет память для структуры. Вызывающий объект должен освободить память, вызвав IMFMediaType::FreeRepresentation.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_ATTRIBUTENOTFOUND
 Сведения о типе носителя не соответствуют запрошенным представлениям.
MF_E_INVALIDMEDIATYPE
 Недопустимый тип носителя.
MF_E_UNSUPPORTED_REPRESENTATION
 Тип носителя не поддерживает запрошенное представление.

Комментарии

При запросе определенной структуры формата в параметре guidRepresentation , например VIDEOINFOHEADER, некоторые сведения о формате могут быть потеряны.

Вы также можете использовать функцию MFInitAMMediaTypeFRomMFMediaType для преобразования типа мультимедиа Media Foundation в тип мультимедиа DirectShow.

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK для Windows Media Format 11:

  • Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
  • Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления за октябрь 2006 г. для Windows XP Media Center Edition).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfobjects.h (включая Mfidl.h)
Библиотека Mfuuid.lib

См. также раздел

IMFMediaType

MFVIDEOFORMAT

Типы носителей