ExtCreateRegion function (wingdi.h)

Article
10/13/2021

The ExtCreateRegion function creates a region from the specified region and transformation data.

Syntax

HRGN ExtCreateRegion(
  [in] const XFORM   *lpx,
  [in] DWORD         nCount,
  [in] const RGNDATA *lpData
);

Parameters

[in] lpx

A pointer to an XFORM structure that defines the transformation to be performed on the region. If this pointer is NULL, the identity transformation is used.

[in] nCount

The number of bytes pointed to by lpRgnData.

[in] lpData

A pointer to a RGNDATA structure that contains the region data in logical units.

Return value

If the function succeeds, the return value is the value of the region.

If the function fails, the return value is NULL.

Remarks

Region coordinates are represented as 27-bit signed integers.

An application can retrieve data for a region by calling the GetRegionData function.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	wingdi.h (include Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll