BdaPropertyTemplateConnections 関数 (bdasup.h)

[アーティクル]
02/22/2024

BdaPropertyTemplateConnections 関数は、テンプレートトポロジでピンの種類とノードの種類がどのように接続されるかを説明する接続の一覧を取得します。

構文

NTSTATUS BdaPropertyTemplateConnections(
  [in]            PIRP                   pIrp,
  [in]            PKSPROPERTY            pKSProperty,
  [out, optional] PKSTOPOLOGY_CONNECTION pConnectionProperty
);

パラメーター

[in] pIrp

接続の一覧を取得する要求の IRP を指します。 BDA ミニドライバーは、 KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 要求でこの IRP を受け取ります。

[in] pKSProperty

プロパティ要求のプロパティと要求の種類を記述する KSPROPERTY 構造体を指します。

[out, optional] pConnectionProperty

テンプレートトポロジ内の接続を記述するKSTOPOLOGY_CONNECTION 構造体の一覧を受け取る配列を指します。

戻り値

STATUS_SUCCESSまたは適切なエラーコードを返します。

注釈

BDA ミニドライバーは 、BdaPropertyTemplateConnections 関数を呼び出して、ミニドライバーがネットワークプロバイダーから KSPROPSETID_BdaTopology プロパティセットの KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 要求を受信した後に、テンプレート接続の一覧を取得します。ほとんどの BDA ミニドライバーは、ディスパッチテーブルとフィルターオートメーションテーブルを定義できるため、これらのミニドライバーは、内部 get ハンドラー (KStrGetPropertyHandler) を使用してこの要求をインターセプトすることなく、BdaPropertyTemplateConnections 関数を直接ディスパッチできます。詳細については、「自動化テーブルの定義」および「BDA デバイストポロジの決定」を参照してください。

BDA ミニドライバーは、BDA ミニドライバーが BdaCreateFilterFactory および BdaInitFilter 関数呼び出しで BDA フィルターテンプレート (BDA_FILTER_TEMPLATE) を渡したときに、KSTOPOLOGY_CONNECTION構造体の配列で BDA サポートライブラリへの接続の一覧を提供しました。この配列は、フィルター内、またはフィルターと隣接するフィルターの間で行うことができるノードとピンの種類の間で可能なすべての接続を表します。 BdaPropertyTemplateConnections 関数は、この配列を返します。