BdaPropertyTemplateConnections-Funktion (bdasup.h)

Artikel
02/26/2024

Die BdaPropertyTemplateConnections-Funktion ruft eine Liste von Verbindungen ab, die beschreiben, wie Pintypen und Knotentypen in einer Vorlagentopologie verbunden sind.

Syntax

NTSTATUS BdaPropertyTemplateConnections(
  [in]            PIRP                   pIrp,
  [in]            PKSPROPERTY            pKSProperty,
  [out, optional] PKSTOPOLOGY_CONNECTION pConnectionProperty
);

Parameter

[in] pIrp

Zeigt auf den IRP für die Anforderung zum Abrufen der Verbindungsliste. Der BDA-Minidriver empfängt diese IRP mit der KSPROPERTY_BDA_TEMPLATE_CONNECTIONS Anforderung.

[in] pKSProperty

Verweist auf eine KSPROPERTY-Struktur , die die Eigenschaft und den Anforderungstyp der Eigenschaftsanforderung beschreibt.

[out, optional] pConnectionProperty

Zeigt auf ein Array, das die Liste der KSTOPOLOGY_CONNECTION Strukturen empfängt, die die Verbindungen in einer Vorlagentopologie beschreiben.

Rückgabewert

Gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Ein BDA-Minidriver ruft die BdaPropertyTemplateConnections-Funktion auf, um die Liste der Vorlagenverbindungen abzurufen, nachdem der Minidriver eine KSPROPERTY_BDA_TEMPLATE_CONNECTIONS Anforderung der KSPROPSETID_BdaTopology-Eigenschaft vom Netzwerkanbieter erhalten hat. Die meisten BDA-Minidriver können Dispatch- und Filterautomatisierungstabellen definieren, sodass diese Minidriver die BdaPropertyTemplateConnections-Funktion direkt senden, ohne diese Anforderung mithilfe eines internen Get-Handlers (KStrGetPropertyHandler) abzufangen. Weitere Informationen finden Sie unter Definieren von Automatisierungstabellen und Bestimmen der BDA-Gerätetopologie .

Der BDA-Minidriver stellte eine Liste von Verbindungen mit der BDA-Unterstützungsbibliothek in einem Array von KSTOPOLOGY_CONNECTION Strukturen bereit, wenn der BDA-Minidriver die BDA-Filtervorlage (BDA_FILTER_TEMPLATE) in BdaCreateFilterFactory - und BdaInitFilter-Funktionsaufrufen übergeben hat. Dieses Array ist eine Darstellung aller möglichen Verbindungen zwischen Knoten- und Pintypen, die innerhalb des Filters oder zwischen dem Filter und angrenzenden Filtern hergestellt werden können. Die BdaPropertyTemplateConnections-Funktion gibt dieses Array zurück.