Platform SDK: Broadcast Architecture

BPCVBIControl.VBIStatus

The VBIStatus method returns information about the channel and tuning space to which the tuner is currently tuned. VBIStatus also returns a value indicating the strength of the VBI signal. Visual Basic syntax is shown.

object.VBIStatus(lPriority, lTuningSpace, lChannel, lVideoSubchannel, _ 
  lAudioSubchannel, lSignalStrength)

Parts

object
Object expression that resolves to a BPCVBIControl object.
lPriority
Reserved. This parameter always receives zero.
lTuningSpace
Long that receives an identifier for the tuning space.
lChannel
Long that receives the channel number.
lVideoSubchannel
Long that receives an identifier for the video subchannel.
lAudioSubchannel
Long that receives an identifier for the audio subchannel.
lSignalStrength
Long that receives the strength of the specified channel. The units of measurement for and valid value of the signal strength depend on the type of device. The values for an analog television tuner are defined in the DirectShow SDK.

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

Examples

The following example receives tuning information about the channel that the tuner is currently using to receive VBI data.

Dim vbictrl As BPCVBIControl
Set vbictrl = New BPCVBIControl
 
' Declare variables to receive the information.
Dim priority As Long
Dim tuningsp As Long
Dim channel As Long
Dim vidsubchl As Long
Dim audsubchl As Long
Dim sigstr As Long
 
' Retrieve the current VBI tuning information.
vbictrl.VBIStatus priority, tuningsp, channel, vidsubchl, audsubchl, sigstr