EngMovePointer function (winddi.h)

The EngMovePointer function moves the engine-managed pointer on the device.


ENGAPI VOID EngMovePointer(
  [in] SURFOBJ *pso,
  [in] LONG    x,
  [in] LONG    y,
  [in] RECTL   *prcl


[in] pso

Pointer to a SURFOBJ structure that describes the display device surface on which the pointer is to be moved.

[in] x

Specify the x-coordinate on the display where the hot spot of the pointer should be positioned.

A negative x value indicates that the pointer should be removed from the display because drawing is about to occur at its present location. If the pointer has been removed from the display and the x value is nonnegative, the pointer should be restored.

[in] y

Specify the y-coordinate on the display where the hot spot of the pointer should be positioned.

[in] prcl

Pointer to a RECTL structure defining an area that bounds all pixels affected by the pointer on the display. The driver should pass the prcl parameter received by its DrvMovePointer function. GDI will not draw in this rectangle without first removing the pointer from the screen. This parameter can be NULL.

Return value



EngMovePointer must not be called while any thread is drawing in the display driver.


Minimum supported client Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform Universal
Header winddi.h (include Winddi.h)
Library Win32k.lib
DLL Win32k.sys

See also