Метод CMediaType.ReallocFormatBuffer

  • Статья

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

Метод ReallocFormatBuffer перераспределяет блок формата до нового размера.

Синтаксис

BYTE* ReallocFormatBuffer(
   ULONG length
);

Параметры

length

Новый размер, необходимый для блока форматирования, в байтах. Должен быть больше нуля.

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

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

Комментарии

Этот метод выделяет новый блок формата. Он копирует как можно больше существующего блока формата в новый блок форматирования. Если новый блок меньше существующего, существующий блок формата усекается. Если новый блок больше, содержимое дополнительного пространства не определено. Для них явно не задано нулевое значение.

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

Требования

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

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

Класс CMediaType