◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
MCI_RECORD
 
        This MCI command message starts recording from the current
        position or from the specified position until the specified
        position. 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_RECORD:
 
            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 lpRecord.
 
            MCI_WAIT
                Specifies that recording should finish before MCI
                returns control to the application.
 
            MCI_RECORD_INSERT
                Indicates that newly recorded information should be
                inserted or pasted into the existing data. (Some devices
                may not support this.) If supported, this is the
                default.
 
            MCI_FROM
                Specifies that a starting position is included in the
                dwFrom field of the data structure identified by
                lpRecord. The units assigned to the position values is
                specified with the MCI_SET_TIME_FORMAT flag of the
                MCI_SET command. If MCI_FROM is not specified, the
                starting position defaults to the current location.
 
            MCI_RECORD_OVERWRITE
                Specifies that data should overwrite existing data.
 
                MCIWAVE returns MCIERR_UNSUPPORTED_FUNCTION in response
                to this flag.
 
            MCI_TO
                Specifies that an ending position is included in the
                dwTo field of the data structure identified by lpRecord.
                The units assigned to the position values is specified
                with the MCI_SET_TIME_FORMAT flag of the MCI_SET
                command. If MCI_TO is not specified, the ending position
                defaults to the end of the media.
 
        LPMCI_RECORD_PARMS lpRecord
            Specifies a far pointer to the MCI_RECORD_PARMS data
            structure. (Devices with extended command sets might replace
            this data structure with a device-specific data structure.)
 
Return value
        Returns zero if successful. Otherwise, it returns an MCI error
        code.
 
        MCISEQ returns MCIERR_UNSUPPORTED_FUNCTION for this command.
 
Comments
        This command is supported by devices that return TRUE to the
        MCI_GETDEVCAPS_CAN_RECORD query.
 
See also
        MCI_CUE, MCI_PAUSE, MCI_PLAY, MCI_RESUME,
        MCI_SEEK
 
                                       -♦-