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