Shuts down the created object.
public:
HRESULT ShutdownObject()
Type: HRESULT
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. |
Refer to Media Foundation return codes.
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.
Header: Declared in mfobjects.h (include mfidl.h).
Library: Use Mfuuid.lib.