接続トポロジのマッピング

BDA サポート ライブラリが BDA ミニドライバーに代わって、リング 3 のアプリケーションにプロパティとメソッドを提供するには、BDA ミニドライバーから BDA サポート ライブラリへの接続トポロジのマッピングを提供する必要があります。 BDA ミニドライバーでは、BDA_TEMPLATE_CONNECTION 構造体の配列で、このマッピングが使用できます。 BDA ミニドライバーは、BdaCreateFilterFactory サポート関数を呼び出す際に、この BDA_TEMPLATE_CONNECTION 配列を KSTOPOLOGY_CONNECTION 構造体の配列で渡します。 詳細については、「BDA ミニドライバーの起動」を参照してください。 この配列は、フィルター内、またはフィルターと隣接するフィルターの間で利用可能なノードとピンの種類の間で想定されるすべての接続を表します。

ネットワーク プロバイダー フィルターは、BDA ミニドライバーのフィルター インスタンスに設定された KSPROPSETID_BdaTopology プロパティに対して KSPROPERTY_BDA_TEMPLATE_CONNECTIONS プロパティ要求を行い、ミニドライバーの接続トポロジを取得します。 BDA ミニドライバーは、 BdaPropertyTemplateConnections サポート関数を呼び出し、フィルターのテンプレート接続 (BDA_TEMPLATE_CONNECTION 構造体) の一覧を KSTOPOLOGY_CONNECTION 構造体の配列で返します。 BDA_TEMPLATE_CONNECTION 構造体のメンバーは、接続のノードとピンの種類の次のペアを識別します。

• 接続を開始するノードとピンの種類

• 接続を終了するノードとピンの種類

ノードの種類を -1 の値に設定すると、接続がアップストリーム フィルターまたはダウンストリーム フィルターのいずれかのピンで開始または終了することを示します。 それ以外の場合、ノードの種類の値は内部ノードの種類の、ゼロベース配列の要素のインデックスに対応します。 この配列は、KSNODE_DESCRIPTOR 構造体の配列です。 ピンの種類の値は、BDA ミニドライバーのテンプレート フィルター記述子で使用可能なピンの種類のゼロベース配列の要素のインデックスに対応します。 この配列は、KSPIN_DESCRIPTOR_EX 構造体の配列です。

次のコード スニペットは、BDA ミニドライバーのテンプレート フィルター記述子で使用できるノードとピンの種類の配列の例を示しています。

//
//  Template Node Descriptors
//
//  This array describes all Node Types available in the template
//  topology of the filter.
//
const
KSNODE_DESCRIPTOR
NodeDescriptors[] =
{
    {   // 0 node type
        &RFTunerNodeAutomation,// PKSAUTOMATION_TABLE AutomationTable;
        &KSNODE_BDA_RF_TUNER,  // Type
        NULL                   // Name
    },
    {   // 1 node type
        &VSB8DemodulatorNodeAutomation, // PKSAUTOMATION_TABLE 
                                        // AutomationTable;
        &KSNODE_BDA_8VSB_DEMODULATOR,   // Type
        NULL                            // Name
    }
};
//
//  Template Pin Descriptors
//
//  This data structure defines the pin types available in the filters
//  template topology. These structures will be used to create a
//  pin factory ID for a pin type when BdaMethodCreatePin is called.
//
const
KSPIN_DESCRIPTOR_EX
TemplatePinDescriptors[] =
{
    //  Antenna Pin
    //  0 pin type
    {
        &AntennaPinDispatch,
        &AntennaAutomation,   // AntennaPinAutomation
        {
            0,  // Interfaces
            NULL,
            0,  // Mediums
            NULL,
            SIZEOF_ARRAY(AntennaPinRanges),
            AntennaPinRanges,
            KSPIN_DATAFLOW_IN,
            KSPIN_COMMUNICATION_BOTH,
            NULL,   // Name
            NULL,   // Category
            0
        },
        KSPIN_FLAG_DO_NOT_USE_STANDARD_TRANSPORT | 
        KSPIN_FLAG_FRAMES_NOT_REQUIRED_FOR_PROCESSING | 
        KSPIN_FLAG_FIXED_FORMAT,
        1,      // InstancesPossible
        0,      // InstancesNecessary
        NULL,   // Allocator Framing
        NULL    // PinIntersectHandler
    },

    //  Transport Pin
    //  1 pin type
    {
        &TransportPinDispatch,
        &TransportAutomation,   // TransportPinAutomation
        {
            0,  // Interfaces
            NULL,
            1,  // Mediums
            &TransportPinMedium,
            SIZEOF_ARRAY(TransportPinRanges),
            TransportPinRanges,
            KSPIN_DATAFLOW_OUT,
            KSPIN_COMMUNICATION_BOTH,
            (GUID *) &PINNAME_BDA_TRANSPORT,   // Name
            (GUID *) &PINNAME_BDA_TRANSPORT,   // Category
            0
        },
        KSPIN_FLAG_DO_NOT_USE_STANDARD_TRANSPORT | 
        KSPIN_FLAG_FRAMES_NOT_REQUIRED_FOR_PROCESSING | 
        KSPIN_FLAG_FIXED_FORMAT,
        1,
        1,      // InstancesNecessary
        NULL,   // Allocator Framing
        NULL    // PinIntersectHandler
    }
};

次のコード スニペットは、テンプレート接続と結合の配列の例を示しています。

//
//  BDA Template Topology Connections
//
//  Lists the possible connections between pin types and
//  node types. This structure along with the BDA_FILTER_TEMPLATE, 
//  KSFILTER_DESCRIPTOR, and BDA_PIN_PAIRING structures 
//  describe how topologies are created in the filter.
//
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 
};
//
//  Lists the template joints between antenna (input) and transport 
//  (output) pin types. Values given to joints correspond to indexes 
//  of elements in the preceding KSTOPOLOGY_CONNECTION array.
// 
//  For this template topology, the RF node (0) belongs to the antenna 
//  pin and the 8VSB demodulator node (1) belongs to the transport pin
//
const
ULONG   AntennaTransportJoints[] =
{
    1  // Second element in the preceding KSTOPOLOGY_CONNECTION array.
};