DVM_DST_RECT

Notifies a video capture driver to set and retrieve the destination rectangle used by a video device channel.

lpDstRect

Address of a RECT structure.

dwFlags

Flags that indicate the type of transfer requested. The following flags are defined:

VIDEO_CONFIGURE_SET

Sends a rectangle to the device driver.

VIDEO_CONFIGURE_GET

Gets the current rectangle from the device driver.

VIDEO_CONFIGURE_MIN

Gets the minimum destination rectangle from the device driver.

VIDEO_CONFIGURE_MAX

Gets the maximum destination rectangle from the device driver.

VIDEO_CONFIGURE_CURRENT

Gets or sets the current destination rectangle.

VIDEO_CONFIGURE_QUERY

Interrogates the device driver to determine if it supports the message.


Either the VIDEO_CONFIGURE_SET or the VIDEO_CONFIGURE_GET flag must be set to specify the direction of the transfer.

The use of the destination rectangle for a channel depends on the channel type. For the VIDEO_EXTERNALIN channel, the destination rectangle specifies the location in the frame buffer used to digitize the image. This rectangle is specified in pixel coordinates.

For the VIDEO_EXTERNALOUT channel, the destination rectangle specifies the location used to display the overlay image. This rectangle is given in Windows screen coordinates.

For the VIDEO_IN and VIDEO_OUT channels, the destination rectangle is currently undefined.