EngMovePointer function (winddi.h)

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

Syntax

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

Parameters

[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

None

Remarks

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

Requirements

See also

DEVINFO

DrvMovePointer

EngSetPointerShape

SURFOBJ