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


Метод CMediaType.AllocFormatBuffer

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

Метод AllocFormatBuffer выделяет память для блока форматирования.

Синтаксис

BYTE* AllocFormatBuffer(
   ULONG length
);

Параметры

length

Размер, необходимый для блока форматирования, в байтах.

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

В случае успешного выполнения возвращает указатель на новый блок. В противном случае возвращает значение NULL.

Комментарии

Если метод успешно выделяет новый блок формата, он освобождает существующий блок форматирования. Если выделение не удается, метод оставляет существующий блок форматирования.

Метод обновляет элементы cbFormat и pbFormatструктуры AM_MEDIA_TYPE .

Требования

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

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

Класс CMediaType