BPCVBIControl.VBITune

[This is preliminary documentation and subject to change.]

The VBITune method tunes the television tuner to the channel and tuning space which is broadcasting the VBI data.

Syntax

object.VBITune(lPriority, lTuningSpace, lChannel, lVideoSubchannel, lAudioSubchannel)
 

Parameters

object

Object expression that resolves to a BPCVBIControl object.

lPriority

Reserved. This parameter should be set to 0.

lTuningSpace

Long that indicates the tuning space.

lChannel

Long that indicates the channel number.

lVideoSubchannel

Long that indicates the video subchannel.

If you do not know the subchannel value, set this parameter to AMTUNER_SUBCHAN_DEFAULT. This flag is declared in the file Axextend.idl. To locate more information on Axextend.idl, see Further Information on Streaming Video Services for the Client.

lAudioSubchannel

Long that indicates the audio subchannel.

If you do not know the subchannel value, set this parameter to AMTUNER_SUBCHAN_DEFAULT.

QuickInfo

  Windows NT: Unsupported.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in vidsvr.odl.
  Import Library: Included as a resource in vid.ocx.
  Unicode: Yes.

See Also

BPCVBIControl.VBIStatus, Tuning to Receive VBI Data

Examples

The following example causes the television tuner to receive VBI data over broadcast channel 27. When the data transmission is complete, the BPCVBIControl object is set to Nothing. This causes the tuner to receive VBI data using the default VBI channel, if any, defined in the registry.

Dim vbictrl As BPCVBIControl
Set vbictrl = New BPCVBIControl
 
'Set the tuner to receive VBI data on channel 27
vbictrl.VBITune 0, 2, 27, AMTUNER_SUBCHAN_DEFAULT, _
                                AMTUNER_SUBCHAN_DEFAULT 
 
'... Code to receive and process the VBI data
 
'Release the tuner to receive VBI data using the default channel
'specified in the system registry.
Set vbictrl = Nothing