MCI_SETTUNER - Description

This message causes the digital video MCD to change the frequency that the tuner device is tuned to.

ulParam1 (ULONG)

This parameter can contain the following flags

MCI_NOTIFY

Posts a notification message to the window specified in the hwndCallback parameter of the data structure identified by ulParam2 when the action indicated by this message is completed.
MCI_WAIT
Does not return control until the action indicated by this message is completed.
MCI_DGV_FREQUENCY
Sets the frequency being sent to the device driver to the value in the ulFrequency field of the MCI_DGV_TUNER_PARMS structure. Overrides channel, region, and fine-tuning.
MCI_DGV_TV_CHANNEL
Sets the channel to the value in the ulTVChannel field of the MCI_DGV_TUNER_PARMS structure. Channel is used along with region and fine-tuning to calculate the frequency.
MCI_DGV_REGION
Sets the channel to the value in the pszRegion field of the MCI_DGV_TUNER_PARMS structure. Region is used along with channel and fine-tuning to calculate the frequency.
MCI_DGV_FINETUNE_PLUS
Indicates that the value in the lFineTune field of the MCI_DGV_TUNER_PARMS structure is positive. Fine-tuning is used along with region and channel to calculate the frequency.
MCI_DGV_FINETUNE_MINUS
Indicates that the value in the lFineTune field of the MCI_DGV_TUNER_PARMS structure is negative. In other words, multiply the value in lFineTune by -1.

pParam2 (PMCI_DGV_TUNER_PARMS)

A pointer to an MCI_DGV_TUNER_PARMS structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

MMPM/2 command completed successfully.
MCIERR_OUT_OF_MEMORY
System out of memory.
MCIERR_TUNER_NO_HW
Device has no tuner support.
MCIERR_TUNER_CHANNEL_SKIPPED
Channel skipped in region.
MCIERR_TUNER_CHANNEL_TOO_HIGH
Channel too high for region.
MCIERR_TUNER_CHANNEL_TOO_LOW
Channel too low for region.
MCIERR_AUD_CHANNEL_OUTOFRANGE
Audio channel out of range.
MCIERR_INVALID_REGION
Region file either does not exist or is invalid.
MCIERR_TUNER_REGION_NOT_SET
Region has not been set.
MCIERR_MISSING_PARAMETER
Missing parameter for this command.
MCIERR_DRIVER
Internal MMPM/2 driver error.
MCIERR_INVALID_FLAG
Invalid flag specified.
MCIERR_MISSING_FLAG
Flag missing for this command.
MCIERR_UNSUPPORTED_FLAG
Flag not supported by this MMPM/2 driver for this command.
MCIERR_FLAGS_NOT_COMPATIBLE
Flags cannot be used together.
MCIERR_INSTANCE_INACTIVE
Instance inactive.

---

[Back: MCI_SETTUNER Return Value - rc]
[Next: MCI_SETTUNER - Remarks]