Platform SDK: Broadcast Architecture

BPCDevices

A BPCDevices object is a collection of all the devices currently available on a computer. In other words, BPCDevices is a collection of BPCDeviceBase objects. The Video Access server creates a BPCDevices object for each BPCVid object. Doing so provides each Video control with a list of the devices available to it.

The BPCDevices class has the property Count, which returns the number of devices currently available. This property is read-only.

The BPCDevices class has the method Item, which returns an item from the BPCDevices collection.

The following events relating to devices listed in BPCDevices are sent by the Video Access server. These events are passed by both the BPCDevices and BPCVid objects to the application that is hosting the Video control. The following events are documented with BPCVid.

Event Description
GotControl The control receiving this event has requested a device and now has the highest priority for use of that device.
LostControl An application with higher priority than the current application requested an input or output device being used by the control. The control receiving this event is losing control of the requested device.

Note that BPCDevices contains several reserved events. For more information on these, see Reserved Events in BPCDevices.

Remarks

Your application should not create an instance of a BPCDevices object directly. Instead, it should obtain the BPCDevices collection using the BPCVid.Devices property.

In the current version of Broadcast Architecture, only analog television tuner cards are listed in the BPCDevices collection. Future versions will support output devices and other input devices, such as devices that play a stored multimedia file.

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, BPCVid, BPCVid.Devices

Example

The following example retrieves the collection of available devices and stores it in the object variable devices.

' Declare an object variable to receive the collection.
Dim devices As BPCDevices
 
' Obtain the collection from the Video control.
Set devices = vid.Devices