IUnregisterPhysicalConnection-Schnittstelle (portcls.h)

  • Artikel

Die IUnregisterPhysicalConnection Schnittstelle implementiert drei Methoden zum Entfernen einer registrierten physischen Verbindung. Der Porttreiber implementiert diese Schnittstelle. Um zu bestimmen, ob ein Porttreiber die IUnregisterPhysicalConnection Schnittstelle unterstützt, ruft ein Miniporttreiber die QueryInterface-Methode des Porttreiberobjekts mit REFIID IID_IUnregisterPhysicalConnection auf. Der Miniporttreiber ist für die Freigabe des IUnregisterPhysicalConnection Objekts verantwortlich, nachdem es nicht mehr benötigt wird. Die IUnregisterPhysicalConnection Schnittstelle erbt von IUnknown.

Die folgenden Porttreiber unterstützen die IUnregisterSubdevice Schnittstelle:

  • WaveCyclic
  • WavePci
  • Topologie
  • DMus
  • MIDI
Die drei Methoden in dieser Schnittstelle heben die Registrierung physischer Verbindungen auf, die zuvor durch Aufrufe der Routinen PcRegisterPhysicalConnection, PcRegisterPhysicalConnectionFromExternal oder PcRegisterPhysicalConnectionToExternal registriert wurden. PortCls unterstützt die dreiXxx-Routinen pcRegisterPhysicalConnection.

Der Porttreiber verwendet die Informationen, die er vonXxx-Aufrufen von PcRegisterPhysicalConnection erhält, um auf KSPROPERTY_PIN_PHYSICALCONNECTION Eigenschaftenanforderungen zu reagieren.

Beim Löschen eines Untergeräts aus der Topologie eines Adapters muss der Treiber die Registrierung der physischen Verbindungen des Untergeräts mit diesem Teil der Topologie aufheben. Wenn die Registrierung der physischen Verbindungen des Untergerätes nicht aufgehoben wird, kann dies zu Speicherverlusten führen.

Vererbung

Die IUnregisterPhysicalConnection-Schnittstelle erbt von der IUnknown-Schnittstelle . IUnregisterPhysicalConnection verfügt auch über folgende Membertypen:

Methoden

Die IUnregisterPhysicalConnection-Schnittstelle verfügt über diese Methoden.

 
IUnregisterPhysicalConnection::UnregisterPhysicalConnection

Die UnregisterPhysicalConnection-Methode löscht die Registrierung einer physischen Verbindung, die durch einen vorherigen Aufruf von PcRegisterPhysicalConnection registriert wurde.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal

Die UnregisterPhysicalConnectionFromExternal-Methode löscht die Registrierung einer physischen Verbindung, die durch einen vorherigen Aufruf von PcRegisterPhysicalConnectionFromExternal registriert wurde.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal

Die UnregisterPhysicalConnectionToExternal-Methode löscht die Registrierung einer physischen Verbindung, die durch einen vorherigen Aufruf von PcRegisterPhysicalConnectionToExternal registriert wurde.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile portcls.h