SETPOSITIONADVISE

The SETPOSITIONADVISE command sets a position change notification for the device. The window handle specified in the hwndCallBack parameter of mciSendString receives the position change notification (MM_MCIPOSITIONCHANGE) messages.

Syntax

SETPOSITIONADVISE ─── object ───┬─ ON ──┬─────────────┬─┬───┬────────────────┬───┬──────────┬───┤
                                │       └─ EVERY units─┘ │   └─ RETURN value ─┘   ├─ WAIT    ─┤
                                └─ OFF ──────────────────┘                        └─ 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: Enables the given position advise. You must specify either the ON or OFF keyword.

EVERY units: The position change notification granularity in the currently set time format.

OFF: Disables the given position advise. You must specify either the ON or OFF keyword.

RETURN value: A value to be returned in the user parameter field of the position change notification message (MM_MCIPOSITIONCHANGE).

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.

Purpose

The SETPOSITIONADVISE command sets a position change notification for the device. The window handle specified in the hwndCallBack parameter of mciSendString receives the position change notification (MM_MCIPOSITIONCHANGE) messages.

Remarks

Devices that do not perform their own event detection might have less accurate position-advise events.

Example

setpositionadvise waveaudio01 off wait