IUnregisterSubdevice interface (portcls.h)

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

The following port drivers support the IUnregisterSubdevice interface:

  • WaveCyclic
  • WavePci
  • Topology
  • DMus
  • MIDI
The single method in this interface unregisters a subdevice that was previously registered by a call to the PcRegisterSubdevice routine. PortCls supports PcRegisterSubdevice.

The IUnregisterSubdevice object maintains its own internal reference to the subdevice to ensure that the corresponding device object is not deleted until all references to the IUnregisterSubdevice object are released.

Inheritance

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

Methods

The IUnregisterSubdevice interface has these methods.

 
IUnregisterSubdevice::UnregisterSubdevice

The UnregisterSubdevice method deletes the registration of a subdevice that was previously registered by a call to PcRegisterSubdevice.

Requirements

Requirement Value
Target Platform Windows
Header portcls.h