SETCUEPOINT

The SETCUEPOINT command sets a cue point. The window handle specified in the hwndCallBack parameter of mciSendString receives the cue point notification (MM_MCICUEPOINT) messages.

This command is not related to the CUE command.

Syntax

SETCUEPOINT ─── object ───┬─ ON AT position ──┬───┬────────────────┬───┬──────────┬───┤
                          └─ OFF AT position ─┘   └─ RETURN value ─┘   ├─ WAIT    ─┤
                                                                       └─ NOTIFY  ─┘

Keywords

object

Object associated with this media control interface command. The object can be one of the following:

Device type
Device name
Filename
Alias

ON AT position: Specifies the location of the cuepoint to enable in the currently set time format.

OFF AT position: Specifies the location of the cuepoint to disable in the currently set time format.

RETURN value: A value to be returned in the user parameter field of the cue point notification message (MM_MCICUEPOINT).

WAIT: The command is executed synchronously. The function waits until the requested action is complete before returning to the application.

NOTIFY: The command is executed asynchronously, allowing control to be returned immediately to the application. When the requested action is complete, an MM_MCINOTIFY message is sent to the application window procedure.

Remarks

Devices that do not perform their own event detection might have less accurate cue points.

Example

setcuepoint waveaudio01 on at 5000 wait