Platform SDK: Broadcast Architecture

BPCVid.Tune

The Tune method tunes the current input device for the Video control to the specified channel. Visual Basic syntax is shown.

object.Tune(lTuningSpace, lChannel, lVideoSubchannel, lAudioSubchannel)

Parts

object
Object expression that resolves to a BPCVid object.
lTuningSpace
Long that specifies the tuning space identifier for the tuning space that contains the channel to tune to. This identifier is either specified in the Guide database or in this registry key:

HKLM\Software\Microsoft\TV Services\Tuning Spaces\

For example, the identifier 2 might represent the "Analog Broadcast TV from Antenna" tuning space.

lChannel
Long that specifies the channel number of the channel.
lVideoSubchannel
Long that specifies the video subchannel for the channel.
lAudioSubchannel
Long that specifies the audio subchannel for the channel.

Remarks

You can use either BPCVid.Tune method or the BPCVid.Input.Channel property to set the channel displayed by the Video control. If your application is simply trying to tune the Video control to a particular channel and it does not matter which device provides the channel, your application can use Tune. Tune automatically sets the BPCVid.Input property to the appropriate device, as identified by the lTuningSpace parameter. However, if it is important that your application set Input to a particular device, you can use the BPCVid.Input.Channel syntax.

Requirements

  Windows NT/2000: Unsupported.
  Windows 95/98: Requires Windows 98.
  Header: Declared in vidsvr.odl.
  Import Library: Included as a resource in vid.ocx.

See Also

BPCDeviceBase.AudioSubchannel, BPCDeviceBase.Channel, BPCDeviceBase.VideoSubchannel, BPCDevices, BPCVid, BPCVid.Input