Метод IMediaSample::GetMediaType (strmif.h)

  • Статья
  • Чтение занимает 2 мин

Метод GetMediaType извлекает тип носителя, если тип носителя отличается от предыдущего примера.

Синтаксис

HRESULT GetMediaType(
  AM_MEDIA_TYPE **ppMediaType
);

Параметры

ppMediaType

Адрес переменной, которая получает указатель на структуру AM_MEDIA_TYPE . Если тип носителя не изменился с предыдущего примера, параметр *ppMediaType имеет значение NULL.

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

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

Код возврата Описание
S_FALSE
 Тип носителя не изменился с предыдущего примера.
S_OK
 Успешно.
E_OUTOFMEMORY
 Недостаточно памяти.

Комментарии

Этот метод позволяет фильтру вносить ограниченные изменения в тип мультимедиа, например изменять палитру. Чтобы внести значительные изменения в тип носителя, может потребоваться повторное подключение и повторное согласование типа носителя.

Если метод возвращает S_OK, вызывающий объект должен освободить память для типа носителя, включая блок формата. Функцию DeleteMediaType можно использовать в библиотеке базовых классов DirectShow.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header strmif.h (include Dshow.h)
Библиотека Strmiids.lib

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

Коды ошибок и успешности

Интерфейс IMediaSample