PcRegisterPhysicalConnectionToExternal-Funktion (portcls.h)
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 |
Weitere Informationen
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal