This command is not supported by all devices. Use the MCI_GETDEVCAPS command to determine whether the device supports MCI_CAPTURE.

Repeated capture commands overwrite the image in the device element buffer. If the application wants to transfer the image data to a permanent file, it can use the MCI_SAVE message with the MCI_DGV_SAVE_IMAGE_FILE flag set. If the application wants the image copied to its address space, it issues MCI_GETIMAGEBUFFER.

The captured image is retained as the device element. With overlay video devices implemented on dual-plane video hardware, the image is captured from the video or image layer.

The media control device can perform the following operations:

• Freeze the motion temporarily, if needed, to capture the image.

• Obtain image data from the device and place the data into the capture and restore buffer.

• Perform an "unfreeze" (if necessary) to return to the original state.

  It will not convert, translate, or change the data from the internal format into another format.

  If no rectangle is specified, the entire video image in the video window is captured.