IUnregisterPhysicalConnection interface (portcls.h)
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 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 |