PcRegisterPhysicalConnection-Funktion (portcls.h)
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 |
Weitere Informationen
IUnregisterPhysicalConnection::UnregisterPhysicalConnection
KSPROPERTY_PIN_PHYSICALCONNECTION