Digital Video Extensions

DWORD lParam1

The following additional flags apply to digital-video devices supporting MCI_WHERE:

MCI_DGV_WHERE_DESTINATION

Obtains a description of the rectangular region used to display video and images in the client area of the current window. The rectangle coordinates are placed in the rc field of the data structure identified by lParam2.

MCI_DGV_WHERE_FRAME

Obtains a description of the rectangular region of the frame buffer into which images from the video rectangle are scaled. The rectangle coordinates are placed in the rc field of the data structure identified by lParam2.

MCI_DGV_WHERE_SOURCE

Obtains a description of the rectangular region cropped from the frame buffer that is stretched to fit the destination rectangle on the display. The rectangle coordinates are placed in the rc field of the data structure identified by lParam2.

MCI_DGV_WHERE_VIDEO

Obtains a description of the rectangular region cropped from the presentation source to fill the frame rectangle in the frame buffer. The rectangle coordinates are placed in the rc field of the data structure identified by lParam2.

MCI_DGV_WHERE_WINDOW

Obtains a description of the display window frame. The rectangle coordinates are placed in the rc field of the data structure identified by lParam2.

MCI_DGV_WHERE_MAX

When used with MCI_DGV_WHERE_DESTINATION, MCI_DGV_WHERE_FRAME, MCI_DGV_WHERE_VIDEO, MCI_DGV_WHERE_SOURCE, or MCI_DGV_WHERE_WINDOW, the rectangle returned indicates the maximum possible width and height of the specified region. The upper-left corner is always 0,0.

LPMCI_DGV_RECT_PARMS lParam2

Specifies a far pointer to a MCI_DGV_RECT_PARMS data structure.

Return Value

Returns zero if successful. Otherwise, it returns an MCI error code.

See Also

MCI_PUT