KSPROPSETID_BdaTopology

KSPROPSETID_BdaTopology is the BDA topology property set. It is used for querying filters about their capabilities.

The following properties are available:

KSPROPERTY_BDA_NODE_TYPES
Returns a list of the node types.

KSPROPERTY_BDA_PIN_TYPES
Returns a list of the pin types.

KSPROPERTY_BDA_TEMPLATE_CONNECTIONS
Returns a list of connections between pins and nodes in a template topology.

KSPROPERTY_BDA_NODE_METHODS
Returns a list of methods supported on a node.

KSPROPERTY_BDA_NODE_PROPERTIES
Returns a list of properties supported on a node.

KSPROPERTY_BDA_NODE_EVENTS
Returns a list of events supported on a node.

KSPROPERTY_BDA_CONTROLLING_PIN_ID
Returns the controlling pin for a node in the BDA template connection list.

KSPROPERTY_BDA_NODE_DESCRIPTORS
Returns a list of nodes.

Comments

The BDA support library provides default methods to handle this property set. The network provider filter uses this property set to determine the template topology of the filter, and the methods, properties and events supported on each node and pin. The network provider filter uses this node and pin information to determine what kinds of operations the filter can perform on the signal and whether to add the filter to the graph. The actual topology of a filter refers to the pin and node connections that are actually made on the filter by the network provider.

The properties in this property set define what the filter can do. Typically, filters are not required to intercept any of these properties. For more information, see Broadcast Driver Architecture Minidrivers on how the BDA minidriver for a filter can use the BDA support library of functions to provide default handling of these properties. A driver writer should create static structures that enable handling of this property set. Once these structures are created and registered with the BDA support library, the driver writer is not required to do anything further to support this property set.