IDigitalCableTuneRequest interface (tuner.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The IDigitalCableTuneRequest interface provides methods for tuning to a channel in a digital cable network. The DigitalCableTuneRequest object implements this interface.

OCUR Devices: This interface supports OpenCable Unidirectional Cable Receiver (OCUR) devices. See OCUR Devices.

Inheritance

The IDigitalCableTuneRequest interface inherits from IATSCChannelTuneRequest. IDigitalCableTuneRequest also has these types of members:

• Methods

Methods

The IDigitalCableTuneRequest interface has these methods.

IDigitalCableTuneRequest::get_MajorChannel The get_MajorChannel method retrieves the major channel number.
IDigitalCableTuneRequest::get_SourceID The get_SourceID method retrieves the source identifier, which maps to a physical channel.
IDigitalCableTuneRequest::put_MajorChannel The put_MajorChannel method sets the major channel number.
IDigitalCableTuneRequest::put_SourceID The put_SourceID method sets the source identifier, which maps to a physical channel.

Remarks

This interface provides three ways to specify the program for the tune request:

• Virtual channel number (VCN). To set the VCN, call IChannelTuneRequest::put_Channel. (This interface inherits IChannelTuneRequest through the IATSCChannelTuneRequest interface.)
• Major channel and minor channel. These are used when an ATSC broadcast is transmitted over cable without remultiplexing the streams. To set the major and minor channels, call IDigitalCableTuneRequest::put_MajorChannel and IATSCChannelTuneRequest::put_MinorChannel, respectively.
• Source identifier. The source identifier is mapped to a physical channel in the virtual channel table. To set the source identifier, call IDigitalCableTuneRequest::put_SourceID.

Only one of these settings should be used in any one tune request. Set the other values equal to BDA_UNDEFINED_CHANNEL (-1). Also, if the physical channel is set in the locator, the physical channel overrides any of these values.

Note that the base channel number from IChannelTuneRequest has a different meaning when it is used in this interface than it does in the IATSCChannelTuneRequest interface. In this interface, the base channel number is the VCN, not the major channel.

To declare the interface identifier (IID) for this interface, use the __uuidof operator: __uuidof(IDigitalCableTuneRequest).

Requirements

Minimum supported client	Windows�Vista [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	tuner.h

See also

IATSCChannelTuneRequest

Tuning Model Interfaces