BdaMethodCreateTopology 関数 (bdasup.h)

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

BdaMethodCreateTopology 関数は、フィルターの 2 つのピン間にテンプレートトポロジを作成します。

構文

NTSTATUS BdaMethodCreateTopology(
  [in]       PIRP      pIrp,
  [in]       PKSMETHOD pKSMethod,
  [optional] PVOID     pvIgnored
);

パラメーター

[in] pIrp

トポロジを作成する要求の IRP をポイントします。 BDA ミニドライバーは、 KSMETHOD_BDA_CREATE_TOPOLOGY 要求でこの IRP を受け取ります。

[in] pKSMethod

メソッド要求のメソッドと要求の種類を記述する KSMETHOD 構造体を指します。

[optional] pvIgnored

無視されるバッファーを指します。

戻り値

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

注釈

BDA ミニドライバーは、BdaMethodCreateTopology 関数を呼び出して、ミニドライバーがネットワークプロバイダーから設定されたKSMETHODSETID_BdaDeviceConfiguration メソッドのKSMETHOD_BDA_CREATE_TOPOLOGY要求を受信した後、2 つのフィルターピン間にテンプレートトポロジを作成します。ほとんどの BDA ミニドライバーは、ディスパッチテーブルとフィルターオートメーションテーブルを定義して、それらのミニドライバーが BdaMethodCreateTopology 関数を 直接ディスパッチできるようにします。一部の BDA ミニドライバーは、直接ディスパッチするのではなく、内部メソッド (KStrMethodHandler) を使用してこの要求をインターセプトする必要があります。これらのミニドライバーは、フィルターを使用して関連付けられているピンを追跡できるように、 BdaMethodCreateTopology を呼び出す前に、渡された IRP から BDA フィルターへのポインターを取得する必要があります。これらのミニドライバーは、特定のピンの種類を接続するときに、ハードウェアに指示を送信できます。詳細については、自動化テーブルの定義と BDA フィルターの構成に関するページを参照してください。

BDA ミニドライバーがネットワークプロバイダーに依存せずに 2 つのフィルターピン間にテンプレートトポロジを作成する必要がある場合、BDA ミニドライバーは BdaCreateTopology 関数を呼び出す必要があります。