MCI_NOTIFY | Specifies that MCI should post the MM_MCINOTIFY message when this command completes. The window that receives this message is specified in the dwCallback field of the data structure identified by lParam2. |
MCI_TEST | Queries the device to determine if it can execute the command. The device returns an error if it is incapable of executing the command. It returns no error if it can handle the command. MCI returns control to the application without executing the command. |
MCI_WAIT | Specifies that the operation should finish before MCI returns control to the application. |
MCI_DGV_RECT | Specifies that the rc field of the data structure identified by lParam2 contains a valid display rectangle. The rectangle specifies the clipping rectangle relative to the client rectangle. |
MCI_DGV_UPDATE_HDC | Specifies that the hDC field of the data structure identified by lParam2 contains a valid window of the display context to paint. This field is required. |
MCI_DGV_UPDATE_PAINT | An application uses this flag when it receives a WM_PAINT message that is intended for a for a display DC. A frame buffer device will usually paint the key color. A device that does not have a frame buffer may ignore the MCI_UPDATE message when the MCI_DGV_UPDATE_PAINT flag is used if it is currently playing because the display will be repainted during the play operation. |
LPMCI_DGV_UPDATE_PARMS lParam2 | Specifies a far pointer to a MCI_DGV_UPDATE_PARMS data structure. |
Return Value | Returns zero if successful. Otherwise, it returns an MCI error code. |
Comments | When the application owns a window (that is, the application specified a window handle with the MCI_WINDOW message), it must send MCI_UPDATE whenever the window needs repainting. For example, an application uses these messages when it responds to a WM_PAINT message. |
| If MCI_DGV_UPDATE_HDC is used without MCI_DGV_UPDATE_PAINT, the video overlay renders the current frame into the provided HDC. Devices supporting this feature will render a full bitmap and not just update the key color. |
| If both MCI_DGV_UPDATE_HDC and MCI_DGV_UPDATE_PAINT are omitted, the contents of the video overlay device's frame buffer are refreshed. This is useful to show new live video data after MCI_UNFREEZE is sent to the driver from a paused state. |