getRegionData 函数 (wingdi.h)

GetRegionData 函数使用描述区域的数据填充指定的缓冲区。此数据包括构成区域的矩形的尺寸。

语法

DWORD GetRegionData(
  [in]  HRGN      hrgn,
  [in]  DWORD     nCount,
  [out] LPRGNDATA lpRgnData
);

[in] hrgn

区域的句柄。

[in] nCount

lpRgnData 缓冲区的大小（以字节为单位）。

[out] lpRgnData

指向接收信息的 RGNDATA 结构的指针。该区域的维度以逻辑单元为单位。如果此参数为 NULL，则返回值包含区域数据所需的字节数。

如果函数成功且 nCount 指定了足够数量的字节，则返回值等于实际使用的字节数 (小于或等于 nCount) 。

如果 lpRgnData 为 NULL，则返回值是所需的字节数。

如果函数失败，则返回值为零。

如果失败是由于 hrgn 无效，则 GetLastError 将返回 ERROR_INVALID_HANDLE。否则， GetLastError 返回 ERROR_INVALID_PARAMETER 。

如果 nCount 太小，则函数将失败。

GetRegionData 函数与 ExtCreateRegion 函数一起使用。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll