Share via


Gdi::GetRegionData_I (Windows Embedded CE 6.0)

1/6/2010

This method fills the specified buffer with data describing a region. This data includes the dimensions of the rectangles that make up the region.

Syntax

static WINGDIAPI DWORD WINAPI GetRegionData_I(
  HRGN hRgn, 
  DWORD dwCount,
  RGNDATA* lpRgnData
);

Parameters

  • hRgn
    [in] Handle to the region.
  • dwCount
    [in] DWORD that specifies the size, in bytes, of the lpRgnData buffer.
  • lpRgnData
    [out] Long pointer to a RGNDATA structure that receives the information.

    If this parameter is NULL, the return value contains the number of bytes needed for the region data.

Return Value

If dwCount specifies an adequate number of bytes, 1 indicates success.

If dwCount is too small or lpRgnData is NULL, the required number of bytes indicates success.

Zero indicates failure.

To get extended error information, call GetLastError.

Remarks

This method is an internal version of the GetRegionData function.

Windows Embedded CE represents regions differently than other Windows-based desktop platforms. Gdi::GetRegionData_I can return more rectangles for a specified region than Windows-based desktop platforms return for the GetRegionData function.

Requirements

Header gdi.hpp
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Gdi
GetRegionData
RGNDATA