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

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:

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

Requirement Value
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