DVM_DST_RECT

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

• Returns DV_ERR_OK if successful or an error code otherwise. The DV_ERR_NOTSUPPORTED error indicates this message is not supported.

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.