Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
MCI_CUE
 
        This MCI command message cues a device so that playback or
        recording begins with minimum delay. Support of this message by
        a device is optional. The parameters and flags for this message
        vary according to the selected device.
 
Parameters
        DWORD dwFlags
            The following flags apply to all devices supporting MCI_CUE:
 
            MCI_NOTIFY
                Specifies that MCI should post the MM_MCINOTIFY message
                when this command completes. The window to receive this
                message is specified in the dwCallback field of the data
                structure identified by lpDefault.
 
            MCI_WAIT
                Specifies that the cue operation should finish before
                MCI returns control to the application.
 
        LPMCI_GENERIC_PARMS lpDefault
            Specifies a far pointer to the MCI_GENERIC_PARMS data
            structure. (Devices with extended command sets might replace
            this data structure with a device-specific data structure.)
 
        Waveform Audio Extensions
 
        DWORD dwFlags
            The following additional flags apply to wave audio devices:
 
            MCI_WAVE_INPUT
                Specifies that a wave input device should be cued.
 
            MCI_WAVE_OUTPUT
                Specifies that a wave output device should be cued.
                This is the default flag if a flag is not specified.
 
        LPMCI_GENERIC_PARMS lpDefault
            Specifies a far pointer to the MCI_GENERIC_PARMS data
            structure.
 
Return value
        Returns zero if successful. Otherwise, it returns an MCI error
        code.
 
See also
        MCI_SEEK, MCI_PLAY, MCI_RECORD
 
                                       -♦-