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:
- 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.
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 |