PcRegisterPhysicalConnectionFromExternal-Funktion (portcls.h)

Artikel
08/07/2023

Die PcRegisterPhysicalConnectionFromExternal-Funktion registriert eine physische Verbindung mit einem Audioadapterfilter aus einem externen Audioadapterfilter.

Syntax

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionFromExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNICODE_STRING FromString,
  [in] ULONG           FromPin,
  [in] PUNKNOWN        ToUnknown,
  [in] ULONG           ToPin
);

Parameter

[in] DeviceObject

Zeiger auf das Geräteobjekt für das Gerät. Dies ist eine Systemstruktur vom Typ DEVICE_OBJECT.

[in] FromString

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den symbolischen Linknamen des externen Filters enthält, der die Quell-Pin der Verbindung bereitstellt.

[in] FromPin

Gibt eine Pin-ID an. Dieser Parameter identifiziert den Quell-Pin (Ausgabe) des externen Filters mit dem Namen FromString.

[in] ToUnknown

Zeiger auf die IPort-Schnittstelle eines Porttreiberobjekts. Das Porttreiberobjekt, das ToUnknown zugeordnet ist, ist an das Untergerät gebunden, das den Pin für die Datensenke (Eingabe) der Verbindung bereitstellt.

[in] ToPin

Gibt eine Pin-ID an. Dieser Parameter identifiziert die Senke (Eingabe) an dem Filter, der der ToUnknown-Schnittstelle zugeordnet ist.

Rückgabewert

PcRegisterPhysicalConnectionFromExternal gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben.

Hinweise

Ein Adaptertreiber ruft PcRegisterPhysicalConnectionFromExternal auf, um eine physische Verbindung mit dem PortCls-Systemtreiber zu registrieren. PortCls speichert diese Informationen, sodass der Porttreiber die Informationen anschließend verwenden kann, um auf KSPROPERTY_PIN_PHYSICALCONNECTION Eigenschaftenanforderungen zu reagieren.

Diese Funktion ist nützlich, um eine Topologieverbindung zwischen zwei Audioadaptern anzugeben, die von verschiedenen Adaptertreibern gesteuert werden. Die Funktion registriert eine physische Verbindung zwischen einem Filterobjekt, das ein Untergerät im lokalen Audioadapter darstellt, und einem Filterobjekt, das ein Untergerät in einem externen Adapter darstellt.

Der FromString-Parameter ist eine symbolische Verknüpfung mit dem Untergerät, das vom externen Adaptertreiber verfügbar gemacht wird.

Die Informationen, die zum Registrieren einer externen physischen Verbindung erforderlich sind, müssen den beiden Treibern zur Verfügung gestellt werden. Dies kann während einer koordinierten Erstinstallation der beiden Geräte erfolgen, oder dies kann dynamisch durch ein Benutzermoduskonfigurationsprogramm erfolgen, das Änderungen an den Konfigurationen beider Geräte koordiniert.

Ein Adaptertreiber kann die IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal-Methode aufrufen, um die Registrierung einer physischen Verbindung zu löschen, die durch einen vorherigen Aufruf von PcRegisterPhysicalConnectionFromExternal registriert wurde. Weitere Informationen finden Sie unter Dynamische Audiountergeräte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Der PortCls-Systemtreiber implementiert die Funktion PcRegisterPhysicalConnectionFromExternal in Microsoft Windows 98/Me und windows 2000 und höher.
Zielplattform	Universell
Header	portcls.h (portcls.h einschließen)
Bibliothek	Portcls.lib
IRQL	PASSIVE_LEVEL