## MMPM/2 Device Driver Reference

[prev][next][parent][TOC]

### VCAI_SETCAPTRECT (6Bh) - Set Source and Destination Capture/Restore Rectangles

Category:
VIDEO_IOCTL_CAT (140)
Function:
VCAI_SETCAPTRECT (6Bh)
Description:
Set Source and Destination Capture/Restore Rectangles

Select an item:

    Description
    Parameter Packet Format
    Data Packet Format

This IOCtl sets up streaming capture of images from the video capture device to buffers provided by the DDCMD_READ message. The portion of the source image to be captured is determined by the size of the destination image.

This command does not start the capture. It specifies the source and destination. Streaming capture is started using the DDCMD_START flag of the ulCmd parameter of the DDCMDCONTROL structure.

The destination X_LEFT and Y_TOP are used only for overlay adapters to control where the overlay image is placed on the screen.

If the device is being used for play back instead of capture as discussed above, source refers to the size of the image that is to be restored and dest (destination) refers to where the image is to be placed. Instead of the DDCMD message discussed above, the image data is passed to the device driver via the VCAI_PLAY IOCtl.