IAMDeviceRemoval interface (strmif.h)

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The IAMDeviceRemoval interface provides a way for the Filter Graph Manager to register for device removal events for a capture device. The KsProxy filter exposes this interface. (See WDM Video Capture Filter.)

Applications typically do not use this interface, and third-party filters do not need to implement this interface. To get a pointer to this interface, call QueryInterface on the KsProxy filter.

Inheritance

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

Methods

The IAMDeviceRemoval interface has these methods.

 
IAMDeviceRemoval::DeviceInfo

The DeviceInfo method retrieves information about the device.
IAMDeviceRemoval::Disassociate

The Disassociate method disassociates the KsProxy filter from the device by closing the device handle. The Filter Graph Manager calls this method if it receives a notification that the device was removed.
IAMDeviceRemoval::Reassociate

The Reassociate method reassociates the KsProxy filter with the device. The Filter Graph Manager calls this method if it receives a notification that the device has returned after being removed.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)

See also

Interfaces