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 関数を呼び出す必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | bdasup.h (Bdasup.h を含む) |
| ライブラリ | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |