MCI_SIGNAL
The MCI_SIGNAL command sets a specified position in the workspace. Digital-video devices recognize this command. MCIAVI supports only one active signal at a time.
MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_SIGNAL,
DWORD dwFlags, (DWORD) (LPMCI_DGV_SIGNAL_PARMS) lpSignal);
Parameters
-
wDeviceID
-
Device identifier of the MCI device that is to receive the command message.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, or MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.
-
lpSignal
-
Address of an MCI_DGV_SIGNAL_PARMS structure.
Return Values
Returns zero if successful or an error otherwise.
Remarks
The window whose handle you specify in the dwCallback member of the MCI_DGV_SIGNAL_PARMS structure receives the MM_MCISIGNAL message.
The following flags apply to digital-video devices:
-
MCI_DGV_SIGNAL_AT
-
A signal position is included in the dwPosition member of the structure identified by lpSignal.
-
MCI_DGV_SIGNAL_CANCEL
-
Removes the signal position specified by the value associated with MCI_DGV_SIGNAL_USERVAL.
-
MCI_DGV_SIGNAL_EVERY
-
A signal-period value is included in the dwPeriod member of the structure identified by lpSignal.
-
MCI_DGV_SIGNAL_POSITION
-
The device will send the position value with the Windows message instead of the user-specified value.
-
MCI_DGV_SIGNAL_USERVAL
-
A data value is included in the dwUserParm member of the structure identified by lpSignal. The data value associated with this request is reported back with the Windows message.
QuickInfo
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in mmsystem.h.
See Also
MCI Overview, MCI Commands, MCI_DGV_SIGNAL_PARMS