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

Функция CreateAudioMediaType

  • Статья

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

Функция CreateAudioMediaType инициализирует тип мультимедиа из структуры WAVEFORMATEX .

Синтаксис

HRESULT STDAPI CreateAudioMediaType(
   const WAVEFORMATEX  *pwfx,
         AM_MEDIA_TYPE *pmt,
         BOOL          bSetFormat
);

Параметры

pwfx

Указатель на предоставленную структуру WAVEFORMATEX .

Pmt

Указатель на инициализируемую структуру AM_MEDIA_TYPE .

bSetFormat

Флаг, указывающий, следует ли инициализировать блок формата. Укажите значение TRUE , чтобы инициализировать его, или FALSE в противном случае.

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

Возвращает E_OUTOFMEMORY, если не удалось выделить память для данных формата; S_OK в противном случае.

Комментарии

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

Требования

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

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

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