GetMetaRgn function (wingdi.h)

The GetMetaRgn function retrieves the current metaregion for the specified device context.

Syntax

int GetMetaRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn
);

Parameters

[in] hdc

A handle to the device context.

[in] hrgn

A handle to an existing region before the function is called. After the function returns, this parameter is a handle to a copy of the current metaregion.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

If the function succeeds, hrgn is a handle to a copy of the current metaregion. Subsequent changes to this copy will not affect the current metaregion.

The current clipping region of a device context is defined by the intersection of its clipping region and its metaregion.

Requirements

See also

Clipping Functions

Clipping Overview

SetMetaRgn