This message is used to set run-time cue points in the media device. The ulCuepoint field is in the current time format, but the cue-point notification messages are returned in MMTIME format.

ulParam1 (ULONG)

This parameter can contain any of the following flags:

MCI_NOTIFY

A notification message will be posted to the window specified in the hwndCallback parameter of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
MCI_WAIT
Control is not to be returned until the action indicated by this message is completed or an error occurs.
MCI_SET_CUEPOINT_ON
This flag is used to set a cue point at the location specified in the ulCuepoint field of the MCI_CUEPOINT_PARMS data structure. The value in the ulCuepoint field is in the current time format.

Note: You can set only one cue point ON or OFF at a time.

MCI_SET_CUEPOINT_OFF
This flag is used to remove a cue point at the location specified in the ulCuepoint field of the MCI_CUEPOINT_PARMS data structure. The location specified must exactly match the location of the previously set cue point.

Note: You can set only one cue point ON or OFF at a time.

pParam2 (PMCI_CUEPOINT_PARMS)

Pointer to MCI_CUEPOINT_PARMS data structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

If the function succeeds, 0 is returned.
MCIERR_INVALID_DEVICE_ID
The device ID is not valid.
MCIERR_INSTANCE_INACTIVE
The device ID is currently inactive. Issue MCI_ACQUIREDEVICE to make device ID active.
MCIERR_MISSING_FLAG
A required flag is missing.
MCIERR_UNSUPPORTED_FLAG
Given flag is unsupported for this device.
MCIERR_INVALID_CALLBACK_HANDLE
Given callback handle is invalid.
MCIERR_FILE_NOT_FOUND
File has not been loaded.
MCIERR_OUT_OF_MEMORY
Out of memory.
MCIERR_OUTOFRANGE
Units is out of range.
MCIERR_DUPLICATE_CUEPOINT
Given cue point already exists.
MCIERR_INVALID_CUEPOINT
Given cue point is invalid.
MCIERR_CUEPOINT_LIMIT_REACHED
The limit for cue points for this device has been reached. Delete one or more cue points and retry this message.
MCIERR_MISSING_PARAMETER
Required parameter is missing.

---

[Back] [Next]