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


Функция ValidateBitmapInfoHeader

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

Функция ValidateBitmapInfoHeader проверяет структуру BITMAPINFOHEADER на наличие некоторых распространенных ошибок, которые могут привести к переполнению буфера или переполнению целых чисел.

Примечание

Эта функция не гарантирует, что структура BITMAPINFOHEADER является допустимой или что код, использующий структуру, является безопасным.

 

Синтаксис

BOOL ValidateBitmapInfoHeader(
   const BITMAPINFOHEADER *pbmi,
         DWORD            cbSize
);

Параметры

pbmi

Указатель на проверяемую структуру BITMAPINFOHEADER .

cbSize

Размер блока памяти, который содержит структуру , в байтах.

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

Возвращает логическое значение. Если значение равно FALSE, то структура BITMAPINFOHEADER недопустима.

Комментарии

Эта функция защищает от следующих ошибок:

  • Арифметическое переполнение в размере структуры или недопустимом размере структуры.
  • Недопустимое значение для элемента biClrUsed .
  • Арифметическое переполнение размера изображения (biSizeImage).
  • Недопустимые значения размера изображения (biSizeImage) для форматов RGB.

Функция не проверка, описывает ли структура допустимый формат видео.

Требования

Требование Значение
Заголовок
Checkbmi.h

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

Функции видео и изображений