Digital Video Extensions

DWORD lParam1

The following additional flag applies to digital-video devices.

MCI_DGV_STEP_FRAMES

Indicates the dwFrames field of the data structure identified by lParam2 specifies the number of frames to advance before showing another image. The default value is one which steps to the next image. Images between the current image and the image stepped to are not stored in the frame buffer. While you can use negative values to specify a reverse sequence, you cannot use MCI_DGV_STEP_REVERSE flag with them.

MCI_DGV_STEP_REVERSE

Steps in reverse.

LPMCI_DGV_STEP_PARMS lParam2

Specifies a far pointer to the MCI_DGV_STEP_PARMS data structure.

Return Value

Returns zero if successful. Otherwise, it returns an MCI error code.

Comments

Only devices that return TRUE to the MCI_GETDEVCAPS_HAS_VIDEO flag of the MCI_GETDEVCAPS command support this command.

For digital-video devices, MCI_STEP advances the position in the workspace to a following image, selects the workspace as the presentation source, and stores the new image in the frame buffer for display. This command always operates on whole frames regardless of the current time format. If the file includes audio, the audio is muted during the step. After a step command, the mode of the device is the same as defined for MCI_SEEK. There might be device-driver specific limitations on what other digital-video instances may be doing during a step.

See Also

MCI_CUE, MCI_PLAY, MCI_SEEK