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