Controlling the Pointer: DrvSetPointerShape

If a display driver controls the pointer, the driver must support DrvSetPointerShape to allow a change in the pointer shape. A call to DrvSetPointerShape has the following effect:

1. If there is an existing pointer that the driver has drawn on the display, the function removes it.

2. It then sets the new shape that has been requested, declining to do so only if it cannot handle the shape.

3. Finally, the new pointer is displayed at the position indicated by the parameters of the call.