IMFActivate::ShutdownObject method (mfobjects.h)

Shuts down the created object.

Syntax

HRESULT ShutdownObject();

Return value

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

Return code	Description
S_OK	The method succeeded.

Remarks

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.

Requirements

Requirement	Value
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

IMFActivate