广播驱动体系（BDA） 系列讲座：六

               定义一个Filter的分发例程时，如有需要，可以指定DEFINE_KSFILTER_NODE_DESCRIPTORS以便在Filter里生成Node。

一个典型的NODE_DESCRIPTORS如下所示

const KSNODE_DESCRIPTOR DgtlTunerFilterNodeDescriptors[] =

{

       {

       &RFTunerNodeAutomation,      // PKSAUTOMATION_TABLE AutomationTable;

       &KSNODE_BDA_RF_TUNER,   // Type

       &guidTunerName               // Name

       },

       {

       &COFDMDemodulatorNodeAutomation, // PKSAUTOMATION_TABLE AutomationTable;

       &KSNODE_BDA_COFDM_DEMODULATOR, // Type

       &guidDemodName                  // Name

       }

} ;

 这里定义了两个Node，每个Node都指定了Automation Table，Node Type 和Name。

一个典型的Automation Tale如下所示

DEFINE_KSAUTOMATION_TABLE(RFTunerNodeAutomation)

{

       DEFINE_KSAUTOMATION_PROPERTIES(RFTunerNodeProperties),

       DEFINE_KSAUTOMATION_METHODS_NULL,

       DEFINE_KSAUTOMATION_EVENTS_NULL

} ;

 

这里只定义了属性集，方法集和事件集都被置为空。进一步的，

RFTunerNodeProperties定义如下

DEFINE_KSPROPERTY_SET_TABLE(RFTunerNodeProperties)

{

       DEFINE_KSPROPERTY_SET

       (

              &KSPROPSETID_BdaFrequencyFilter,                // Set

              SIZEOF_ARRAY(RFTunerBdaFrequencyFilter),        // PropertiesCount

              RFTunerBdaFrequencyFilter,                      // PropertyItems

              0,                                              // FastIoCount

              NULL                                            // FastIoTable

       ),

       DEFINE_KSPROPERTY_SET

       (

              &KSPROPSETID_BdaSignalStats,                    // Set

              SIZEOF_ARRAY(RFTunerBdaSignalStats),            // PropertiesCount

              RFTunerBdaSignalStats,                          // PropertyItems

              0,                                              // FastIoCount

              NULL                                            // FastIoTable

       )

} ;

 可以看到，Tunner Node里扩展了KSPROPSETID_BdaFrequencyFilte和KSPROPSETID_BdaSignalStats 两个属性集。更进一步的，

RFTunerBdaFrequencyFilter的定义如下

DEFINE_KSPROPERTY_TABLE(RFTunerBdaFrequencyFilter)

{

       DEFINE_KSPROPERTY_ITEM

       (

              KSPROPERTY_BDA_RF_TUNER_FREQUENCY_MULTIPLIER,   // 1

              RFTunerNodeGetFrequencyMultiplier,              // GetSupported or Handler

              sizeof(KSP_NODE),                               // MinProperty

              sizeof(DWORD),                                  // MinData

              RFTunerNodeSetFrequencyMultiplier,              // SetSupported or Handler

              NULL,                                           // Values

              0,                                              // RelationsCount

              NULL,                                           // Relations

              NULL,                                           // SupportHandler

              0                                               // SerializedSize

       ),

       DEFINE_KSPROPERTY_ITEM

       (

              KSPROPERTY_BDA_RF_TUNER_FREQUENCY,              // 1

              RFTunerNodeGetFrequency,                        // GetSupported or Handler

              sizeof(KSP_NODE),                               // MinProperty

              sizeof(DWORD),                                  // MinData

              RFTunerNodeSetFrequency,                        // SetSupported or Handler

              NULL,                                           // Values

              0,                                              // RelationsCount

              NULL,                                           // Relations

              NULL,                                          // SupportHandler

              0                                               // SerializedSize

       )

} ;

 该属性集中的KSPROPERTY_BDA_RF_TUNER_FREQUENCY_MULTIPLIER和KSPROPERTY_BDA_RF_TUNER_FREQUENCY属性被扩展。

 BDA架构目前提供的Node Type有如下几个

KSNODE_BDA_RF_TUNER

KSNODE_BDA_QAM_DEMODULATOR

KSNODE_BDA_QPSK_DEMODULATOR

KSNODE_BDA_8VSB_DEMODULATOR

KSNODE_BDA_COFDM_DEMODULATOR

KSNODE_BDA_OPENCABLE_POD

KSNODE_BDA_COMMON_CA_POD

KSNODE_BDA_PID_FILTER

KSNODE_BDA_IP_SINK

Node Name由自己指定，只是不能有重复。

 

指定完Node后，还要指定它们的连接方式。

一个典型的连接定义如下

const
KSTOPOLOGY_CONNECTION TemplateTunerConnections[]  =
{
    {-1,  0,  0,  0}, // from upstream filter to 0 pin of 0 node
    {0,  1,  1,  0}, // from 1 pin of 0 node to 0 pin of 1 node
    {1,  1,  -1, 1}, // from 1 pin of 1 node to downstream filter
} ;

这张表指定了三条连接，如注释中所讲，第一条从前一个filter出来，连到第0个node的第0个pin；第二条从第0个Node的第1个pin出来，连到第1个Node的第0个pin；第三条从第1个Node的第1个pin出来，连后后一个filter。

指定完连接线路后，还要指定一个Node间的连接点。

一个典型的AntennaTransportJoints如下

const
ULONG   AntennaTransportJoints[]  =
{
 1 // Second element in the preceding KSTOPOLOGY_CONNECTION array.
} ;

 

表明Node间的连接点是上面那张链接表中的第二条线路。连接点在指定Node的控制Pin时有用。为什么要指定控制Pin？因为Node从外部是没法访问的，想要访问Node，必须现访问该Node的控制Pin，然后让控制Pin去访问Node。如下图所示

 
Node1处在Pin1和Joint1之间，所以Node1的控制Pin就是Pin1；而Node2处在Joint1和Pin2之间，所以Node2的控制Pin是Pin2。大多数时候一张拓扑图中只有一个连接点。可以通过BdaPropertyGetControllingPinId 函数取得控制Pin的ID。

 

BDA架构允许一个驱动运行很多的实例，但是一个时间里只能有一个实例的状态处于运行状态，因为硬件资源往往只有一个。为此需要提供同步机制，BDA中用方法集来保持同步。一个典型的同步方法集如下所示：

 

DEFINE_KSMETHOD_TABLE(BdaChangeSyncMethods)
{
    DEFINE_KSMETHOD_ITEM_BDA_START_CHANGES(
        CFilter::StartChanges,
        NULL
        ),
    DEFINE_KSMETHOD_ITEM_BDA_CHECK_CHANGES(
        CFilter::CheckChanges,
        NULL
        ),
    DEFINE_KSMETHOD_ITEM_BDA_COMMIT_CHANGES(
        CFilter::CommitChanges,
        NULL
        ),
    DEFINE_KSMETHOD_ITEM_BDA_GET_CHANGE_STATE(
        CFilter::GetChangeState,
        NULL
        )
} ;

 

应用程序引发上述例程，例程实现中通知驱动做相应的操作。

在 CFilter::StartChanges中，调用BdaStartChanges 方法通知驱动开始变更。

在 CFilter::CheckChanges中，调用BdaCheckChanges方法通知驱动检查变更。

在 CFilter::CommitChanges中，调用BdaCommitChanges方法通知驱动提交变更。

在 CFilter::GetChangeState中，调用BdaGetChangeState方法获取当前状态。

 

最后交代一个原则：每次当driver，firmware，或者硬件发生改变时，都调用BdaFilterFactoryUpdateCacheData 更新DirectShow中相应的数据。

 

至此，BDA驱动的大体架构已出。