Edit

IUnregisterPhysicalConnection interface (portcls.h)

  • Article

The IUnregisterPhysicalConnection interface implements three methods to remove a registered physical connection. The port driver implements this interface. To determine whether a port driver supports the IUnregisterPhysicalConnection interface, a miniport driver calls the port driver object's QueryInterface method with REFIID IID_IUnregisterPhysicalConnection. The miniport driver is responsible for releasing the IUnregisterPhysicalConnection object after it is no longer needed. The IUnregisterPhysicalConnection interface inherits from IUnknown.

The following port drivers support the IUnregisterSubdevice interface:

  • WaveCyclic
  • WavePci
  • Topology
  • DMus
  • MIDI
The three methods in this interface "unregister" physical connections that were registered previously by calls to the PcRegisterPhysicalConnection, PcRegisterPhysicalConnectionFromExternal, or PcRegisterPhysicalConnectionToExternal routines. PortCls supports the three PcRegisterPhysicalConnectionXxx routines.

The port driver uses the information that it obtains from PcRegisterPhysicalConnectionXxx calls to respond to KSPROPERTY_PIN_PHYSICALCONNECTION property requests.

When deleting a subdevice from an adapter's topology, the driver must unregister the subdevice's physical connections to that portion of the topology. Failure to unregister the subdevice's physical connections can cause memory leaks.

Inheritance

The IUnregisterPhysicalConnection interface inherits from the IUnknown interface. IUnregisterPhysicalConnection also has these types of members:

Methods

The IUnregisterPhysicalConnection interface has these methods.

 
IUnregisterPhysicalConnection::UnregisterPhysicalConnection

The UnregisterPhysicalConnection method deletes the registration of a physical connection that was registered by a previous call to PcRegisterPhysicalConnection.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal

The UnregisterPhysicalConnectionFromExternal method deletes the registration of a physical connection that was registered by a previous call to PcRegisterPhysicalConnectionFromExternal.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal

The UnregisterPhysicalConnectionToExternal method deletes the registration of a physical connection that was registered by a previous call to PcRegisterPhysicalConnectionToExternal.

Requirements

Requirement Value
Target Platform Windows
Header portcls.h