BdaMethodCreateTopology-Funktion (bdasup.h)
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 Minitreiber 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 zugeordnete Pins nachzuverfolgen. Diese Minidriver 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.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | bdasup.h (include Bdasup.h) |
Bibliothek | Bdasup.lib |
IRQL | PASSIVE_LEVEL |