MCI_SETTUNER command

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

To send this command, call the mciSendCommand function with the following parameters.

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: Pointer to an MCI_VCR_SETTUNER_PARMS structure.

Returns zero if successful or an error otherwise.

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.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Mmsystem.h (include Windows.h)