Share via


IBDA_DeviceControl interface (bdaiface.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The IBDA_DeviceControl interface is implemented on all BDA device filters.

The methods provided by this interface are called by a Network Provider to control a BDA device. Each instance of a device has one transaction list. A Network Provider first calls the StartChanges method. This deletes any previous uncommitted changes that were still pending. Then a Network Provider modifies whatever properties on the filter are required for the particular tuning operation. Then it calls the CheckChanges method to determine whether the modifications will be successful, without instructing the filter to actually make the changes. If this call succeeds, then a Network Provider calls CommitChanges to cause the filter to actually modify the specified properties. For more information, see "Changing BDA Filter Properties" in the Windows DDK.

OCUR Devices: This interface supports OpenCable Unidirectional Cable Receiver (OCUR) devices. See OCUR Devices.

Inheritance

The IBDA_DeviceControl interface inherits from the IUnknown interface. IBDA_DeviceControl also has these types of members:

Methods

The IBDA_DeviceControl interface has these methods.

 
IBDA_DeviceControl::CheckChanges

The CheckChanges method queries the device filter as to whether the changes that are pending would succeed if they were committed.
IBDA_DeviceControl::CommitChanges

The CommitChanges method instructs the device to perform the changes specified in the previous call to StartChanges.
IBDA_DeviceControl::GetChangeState

The GetChangeState method returns a value indicating whether any uncommitted changes are currently pending in the filter.
IBDA_DeviceControl::StartChanges

The StartChanges method is called by a Network Provider before it begins to modify a set of properties on a BDA device filter.

Remarks

To declare the interface identifier (IID) for this interface, use the __uuidof operator: __uuidof(IBDA_DeviceControl).

Requirements

Requirement Value
Target Platform Windows
Header bdaiface.h

See also

BDA Interfaces