BdaMethodCreateTopology-Funktion (bdasup.h)

Artikel
02/22/2024

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 den IRP für die Anforderung zum Erstellen der Topologie. Der BDA-Minidriver empfängt diese 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.

Hinweise

Ein BDA-Minidriver ruft die BdaMethodCreateTopology-Funktion auf, um die Vorlagentopologie zwischen zwei Filternadeln zu erstellen, nachdem der Minitreiber eine KSMETHOD_BDA_CREATE_TOPOLOGY Anforderung des KSMETHODSETID_BdaDeviceConfiguration Methodensatzes vom Netzwerkanbieter empfangen hat. Die meisten BDA-Minitreiber können Dispatch- und Filterautomatisierungstabellen definieren, sodass diese Minitreiber die BdaMethodCreateTopology-Funktion direkt senden. Einige BDA-Minidriver müssen diese Anforderung mithilfe einer internen Methode (KStrMethodHandler) abfangen, anstatt sie direkt zu senden. Diese Mindriver müssen vor dem Aufrufen von BdaMethodCreateTopology einen Zeiger auf den BDA-Filter aus dem übergebenen IRP abrufen, damit sie den Filter verwenden können, um zugeordnete Pins nachzuverfolgen. Diese Mindriver können dann Anweisungen an die Hardware senden, wenn sie bestimmte Pintypen verbinden. Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Konfigurieren eines BDA-Filters .

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