Platform SDK: Broadcast Architecture

BPCVBIControl.VBITune

The VBITune method tunes the television tuner to the channel and tuning space that is broadcasting the VBI data. Visual Basic syntax is shown.

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

Parts

object
Object expression that resolves to a BPCVBIControl object.
lPriority
Reserved. This parameter should be set to zero.
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 the flag AMTUNER_SUBCHAN_DEFAULT. This flag is declared in the file Axextend.idl.
lAudioSubchannel
Long that indicates the audio subchannel. If you do not know the subchannel value, set this parameter to AMTUNER_SUBCHAN_DEFAULT.

Remarks

For more information on working with BPCVBIControl, see Setting a Tuner to Receive VBI Data.

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

BPCVBIControl, BPCVBIControl.VBIStatus

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. Setting the object to Nothing causes the tuner to receive VBI data using the default VBI channel defined in the registry, if any.

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 computer registry.
Set vbictrl = Nothing