PcRegisterPhysicalConnectionToExternal-Funktion (portcls.h)

Artikel
02/26/2024

Die PcRegisterPhysicalConnectionToExternal-Funktion registriert eine physische Verbindung zwischen einem Audioadapterfilter und einem externen Audioadapterfilter.

Syntax

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionToExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNKNOWN        FromUnknown,
  [in] ULONG           FromPin,
  [in] PUNICODE_STRING ToString,
  [in] ULONG           ToPin
);

Parameter

[in] DeviceObject

Zeiger auf das Geräteobjekt für das Gerät. Hierbei handelt es sich um eine Systemstruktur vom Typ DEVICE_OBJECT.

[in] FromUnknown

Zeiger auf die IPort-Schnittstelle eines Porttreiberobjekts. Das Porttreiberobjekt, das FromUnknown zugeordnet ist, ist an das Untergerät gebunden, das den Pin der Datenquelle (Ausgabe) der Verbindung bereitstellt.

[in] FromPin

Gibt eine Pin-ID an. Dieser Parameter identifiziert den Quell- (Ausgabe-)Pin auf dem Filter, der der FromUnknown-Schnittstelle zugeordnet ist.

[in] ToString

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

[in] ToPin

Gibt eine Pin-ID an. Dieser Parameter identifiziert die Senke (Eingabe)-Pin für den externen Filter mit dem Namen ToString.

Rückgabewert

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

Hinweise

Ein Adaptertreiber ruft PcRegisterPhysicalConnectionToExternal 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 ToString-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 an die beiden Treiber übermittelt werden. Dies kann entweder während einer anfänglich koordinierten Installation der beiden Geräte oder dynamisch durch ein Benutzermoduskonfigurationsprogramm erfolgen, das Änderungen an der Konfiguration beider Geräte koordiniert.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Der PortCls-Systemtreiber implementiert die PcRegisterPhysicalConnectionToExternal-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höheren Betriebssystemen.
Zielplattform	Universell
Header	portcls.h (include Portcls.h)
Bibliothek	Portcls.lib
IRQL	PASSIVE_LEVEL