MCI_SETTUNER

The MCI_SETTUNER command sets the current channel on the tuner. VCR devices recognize this command.

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_SETTUNER, 
    DWORD dwFlags, (DWORD) (LPMCI_GENERIC_PARMS) lpSetTuner);
 

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.

lpSetTuner

Address of an MCI_VCR_SETTUNER_PARMS structure.

Return Values

Returns zero if successful or an error otherwise.

Remarks

The following additional flags apply to VCR devices:

MCI_VCR_SETTUNER_CHANNEL

The dwChannel member of the structure identified by lpSetTuner contains the new channel number.

MCI_VCR_SETTUNER_CHANNEL_DOWN

Decrements the tuner channel.

MCI_VCR_SETTUNER_CHANNEL_SEEK_DOWN

Searches for a valid channel in the reverse direction.

MCI_VCR_SETTUNER_CHANNEL_SEEK_UP

Searches for a valid channel in the forward direction.

MCI_VCR_SETTUNER_CHANNEL_UP

Increments the tuner channel.

MCI_VCR_SETTUNER_NUMBER

The dwNumber member of the structure identified by lpSetTuner specifies which logical tuner to affect with this command.

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_VCR_SETTUNER_PARMS