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


Метод CDrawImage.NotifyMediaType

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Метод NotifyMediaType уведомляет объект CDrawImage о текущем типе мультимедиа.

Синтаксис

void NotifyMediaType(
   CMediaType *pMediaType
);

Параметры

pMediaType

Указатель на объект CMediaType или NULL для очистки типа мультимедиа.

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

Этот метод не возвращает значение.

Комментарии

Фильтр владельцев должен вызывать этот метод при изменении типа носителя. Обычно это происходит при первом подключении контакта и после изменения динамического формата.

Объект CDrawImage хранит указатель pMediaType в переменной-члене m_pMediaType . Таким образом, если вызывающему объекту необходимо освободить объект CMediaType , он должен обновить объект CDrawImage , вызвав этот метод еще раз с помощью нового указателя или со значением NULL . В противном случае может возникнуть ошибка, когда объект CDrawImage пытается ссылаться на старый указатель.

Требования

Требование Значение
Заголовок
Winutil.h (включая Streams.h)
Библиотека
Strmbase.lib (розничные сборки);
Strmbasd.lib (отладочные сборки)

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

Класс CDrawImage