ValidateBitmapInfoHeader 函数

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

函数 ValidateBitmapInfoHeader 检查 BITMAPINFOHEADER 结构中是否存在可能导致缓冲区溢出或整数溢出的某些常见错误。

注意

此函数不保证 BITMAPINFOHEADER 结构有效，也不保证使用该结构的代码是安全的。

 

语法

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

参数

pbmi

指向要验证的 BITMAPINFOHEADER 结构的指针。

cbSize

保存结构的内存块的大小（以字节为单位）。

返回值

返回一个布尔值。 如果值为 FALSE，则 BITMAPINFOHEADER 结构无效。

备注

此函数可防范以下错误：

• 结构大小中的算术溢出或结构大小无效。
• biClrUsed 成员的值无效。
• 图像大小中的算术溢出 (biSizeImage) 。
• rgb 格式的图像大小 (biSizeImage) 值无效。

函数不检查 结构是否描述有效的视频格式。

要求

要求	值
标头	Checkbmi.h

另请参阅

视频和图像函数