BdaMethodCreateTopology-Funktion (bdasup.h)

Artikel
02/06/2025

Die BdaMethodCreateTopology--Funktion erstellt eine Vorlagentopologie zwischen zwei Pins eines Filters.

Syntax

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

Parameter

[in] pIrp

Verweist auf das IRP für die Anforderung zum Erstellen der Topologie. Der BDA-Minidriver empfängt dieses IRP mit der KSMETHOD_BDA_CREATE_TOPOLOGY Anforderung.

[in] pKSMethod

Verweist auf eine KSMETHOD- Struktur, die die Methode und den Anforderungstyp einer Methodenanforderung beschreibt.

[optional] pvIgnored

Verweist auf einen Puffer, der ignoriert wird.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Bemerkungen

Ein BDA-Minidriver ruft die BdaMethodCreateTopology--Funktion auf, um die Vorlagentopologie zwischen zwei Filter-Pins zu erstellen, nachdem der Minidriver eine KSMETHOD_BDA_CREATE_TOPOLOGY Anforderung der vom Netzwerkanbieter festgelegten KSMETHODSETID_BdaDeviceConfiguration-Methode empfängt. Die meisten BDA-Minidriver können Verteiler- und Filterautomatisierungs-Tabellen definieren, sodass diese Minidriver die BdaMethodCreateTopology direkt verteilen. Einige BDA-Minidriver müssen diese Anforderung mit einer internen Methode (KStrMethodHandler) abfangen, anstatt sie direkt zu verteilen. Diese Minidriver müssen einen Zeiger auf den BDA-Filter aus dem übergebenen IRP abrufen, bevor sie BdaMethodCreateTopology- aufrufen, damit sie den Filter verwenden können, um die zugeordneten Pins nachzuverfolgen. Diese Minidriver können dann Anweisungen an die Hardware senden, wenn bestimmte Pintypen verbunden werden. Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Konfigurieren eines BDA-Filter-.

Wenn ein BDA-Minidriver die Vorlagentopologie zwischen zwei Filter-Pins erstellen muss, ohne sich auf den Netzwerkanbieter zu verlassen, sollte der BDA-Minidriver die BdaCreateTopology--Funktion aufrufen.