The DVM_UPDATE message requests a user-mode video capture driver to update the overlay display.
The driver should return DV_ERR_OK if the operation succeeds. Otherwise, it should return one of the DV_ERR error codes defined in msvideo.h. Custom error codes are also allowed (see DVM_GETERRORTEXT).
A client sends the DVM_UPDATE message by calling the driver’s DriverProc entry point, passing the specified parameter values. Applications can send this message by calling the videoUpdate function, which is described in the Video for Windows Development Kit.
If the hardware supports color keying, the driver should repaint the current key color onto the overlay area. If the key color has not yet been specified, the driver should specify it. The driver should create a brush using the key color, convert the screen coordinates describing the overlay area into client coordinates, and repaint the overlay area, as illustrated in the sample drivers.
Typically, a client sends this message whenever its window receives a WM_PAINT, WM_MOVE, WM_POSITIONCHANGED, or WM_SIZE message. It also typically sends the message after sending a DVM_SRC_RECT or DVM_DST_RECT message.