PcRegisterPhysicalConnection-Funktion (portcls.h)

Artikel
08/07/2023

Die Funktion PcRegisterPhysicalConnection registriert eine physische Verbindung zwischen zwei Audioadapterfiltern, die vom gleichen Adaptertreiber instanziiert werden.

Syntax

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnection(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PUNKNOWN       FromUnknown,
  [in] ULONG          FromPin,
  [in] PUNKNOWN       ToUnknown,
  [in] ULONG          ToPin
);

Parameter

[in] DeviceObject

Zeiger auf das Geräteobjekt für das Adaptergerät. Dieser Parameter muss auf eine Systemstruktur vom Typ DEVICE_OBJECT verweisen.

[in] FromUnknown

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

[in] FromPin

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

[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

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

Hinweise

Ein Adaptertreiber ruft PcRegisterPhysicalConnection 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.

Die Parameter, die der Aufrufer für die PcRegisterPhysicalConnection-Funktion bereitstellt, beschreiben eine physische Verbindung zwischen zwei Untergeräte (dargestellt als einzelne Filter) auf demselben Adapter Karte.

Im Gegensatz zu einer logischen Verbindung zwischen zwei Pins, die unter Softwaresteuerung konfiguriert werden kann, ist eine physische Verbindung festverkabelt. Beispielsweise kann ein typischer Adapter Karte über eine physische Verbindung verfügen, die das analoge Signal vom Ausgabestift seines Wellenausgangsfilters zum Eingangspin des Topologiefilters überträgt.

Ein Beispiel für die Gerätestartroutine eines Adaptertreibers (siehe Startsequenz), die den PcRegisterPhysicalConnection-Aufruf verwendet, um die physischen Verbindungen eines Adapters zu registrieren, finden Sie im Quellcode für den SB16-Beispielaudiotreiber im Microsoft Windows Driver Kit (WDK).

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Der PortCls-Systemtreiber implementiert die PcRegisterPhysicalConnection-Funktion 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