ExtCreateRegion function (wingdi.h)

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

See also

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

GetRegionData

RGNDATA

Region Functions

Regions Overview

XFORM