| MCI_DGV_CUE_INPUT | Indicates a digital-video instance should prepare for recording. If the application has not reserved disk space, the device reserves the disk space using its default parameters. The application can omit this flag if the current presentation source is already the external input. (This flag has no effect on selecting the presentation source.) |
| MCI_DGV_CUE_OUTPUT | Indicates a digital-video instance should prepare for playing. If the workspace is paused, no positioning occurs. If the workspace is stopped, the position might change to a previous key-frame image. The application can omit this flag if the current presentation source is already the workspace. |
| MCI_DGV_CUE_NOSHOW | Indicates a digital-video instance should prepare for playing the frame specified with the command without displaying it. When this flag is specified, the display continues to show the image in the frame buffer even though its corresponding frame is not the current position. For example, if the frame buffer contains the image from frame 7, the device continues to show frame 7 when this flag is used to cue the device to any other position. A subsequent cue command without this flag and without the MCI_TO flag displays the current frame. |
| MCI_TO | Indicates a workspace position is included in the dwTo field of the data structure identified by lParam2. The units assigned to position values are specified using the MCI_SET_TIME_FORMAT flag of the MCI_SET command. This is equivalent to seeking to a position except the device is paused after the command. |
| LPMCI_DGV_CUE_PARMS lParam2 | Specifies a far pointer to the MCI_DGV_CUE_PARMS data structure. |
| Return Value | Returns zero if successful. Otherwise, it returns an MCI error code. |
| Comments | When a device is cued, the device driver performs any time consuming operations it can so that a play or record command will start as quickly as possible. Cueing a device switches an instance in a stopped state to a paused state. |
| See Also | MCI_SEEK, MCI_PLAY, MCI_RECORD |