ExtCreateRegion

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

HRGN ExtCreateRegion(
  CONST XFORM *lpXform,     // pointer to transformation data
  DWORD nCount,             // size of structure containing region data
  CONST RGNDATA *lpRgnData  // pointer to region data
);
 

Parameters

lpXform

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.

nCount

Specifies the number of bytes pointed to by lpRgnData.

lpRgnData

Pointer to a RGNDATA structure that contains the region data.

Return Values

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

If the function fails, the return value is NULL.

Windows NT: To get extended error information, call GetLastError.

Remarks

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

Windows 95 and Windows 98: Regions are no longer limited to the 64K heap.

Windows 95 and Windows 98: World transforms that involve either shearing or rotations are not supported. ExtCreateRegion fails if the transformation matrix is anything other than a scaling or translation of the region.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Regions Overview, Region Functions, GetRegionData, RGNDATA, XFORM