DPtoLP function (wingdi.h)

The DPtoLP function converts device coordinates into logical coordinates. The conversion depends on the mapping mode of the device context, the settings of the origins and extents for the window and viewport, and the world transformation.

Syntax

BOOL DPtoLP(
  [in]      HDC     hdc,
  [in, out] LPPOINT lppt,
  [in]      int     c
);

Parameters

[in] hdc

A handle to the device context.

[in, out] lppt

A pointer to an array of POINT structures. The x- and y-coordinates contained in each POINT structure will be transformed.

[in] c

The number of points in the array.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The DPtoLP function fails if the device coordinates exceed 27 bits, or if the converted logical coordinates exceed 32 bits. In the case of such an overflow, the results for all the points are undefined.

Examples

For an example, see Using Coordinate Spaces and Transformations.

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

Coordinate Space and Transformation Functions

Coordinate Spaces and Transformations Overview

LPtoDP

POINT