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

Функция CopyMediaType

  • Статья

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

Функция CopyMediaType копирует структуру AM_MEDIA_TYPE в другую структуру, включая блок форматирования.

Синтаксис

HRESULT WINAPI CopyMediaType(
         AM_MEDIA_TYPE *pmtTarget,
   const AM_MEDIA_TYPE *pmtSource
);

Параметры

pmtTarget

Указатель на структуру AM_MEDIA_TYPE . Метод копирует тип носителя в эту структуру.

pmtSource

Указатель на исходную AM_MEDIA_TYPE структуру для копирования.

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

Возвращает S_OK или E_OUTOFMEMORY.

Комментарии

Эта функция выделяет память для блока форматирования. Если параметр pmtTarget уже содержит выделенный блок формата, произойдет утечка памяти. Чтобы избежать утечки памяти, вызовите FreeMediaType перед вызовом этой функции.

После возврата метода вызовите FreeMediaType в pmtTarget , чтобы освободить блок форматирования.

Требования

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

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

Функции типов мультимедиа