IMFActivate::ShutdownObject method

Shuts down the created object.


HRESULT ShutdownObject();


This method has no parameters.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
The method succeeded.


If you create an object by calling IMFActivate::ActivateObject, call ShutdownObject when you are done using the object.

The component that calls ActivateObject—not the component that creates the activation object—is responsible for calling ShutdownObject. For example, in a typical playback application, the application creates activation objects for the media sinks, but the Media Session calls ActivateObject. Therefore the Media Session, not the application, calls ShutdownObject.

After ShutdownObject is called, the activation object releases all of its internal references to the created object. If you call ActivateObject again, the activation object will create a new instance of the other object.


Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfobjects.h
Library Mfuuid.lib

See also

Activation Objects