Share via


MCI_SETTUNER

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.

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.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Mmsystem.h; include Windows.h.

See Also

MCI, MCI Commands, MCI_VCR_SETTUNER_PARMS