Edit

Share via

IMFShutdown interface (mfidl.h)

  • Article

Exposed by some Media Foundation objects that must be explicitly shut down.

Inheritance

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

Methods

The IMFShutdown interface has these methods.

 
IMFShutdown::GetShutdownStatus

Queries the status of an earlier call to the IMFShutdown::Shutdown method.
IMFShutdown::Shutdown

Shuts down a Media Foundation object and releases all resources associated with the object. (IMFShutdown.Shutdown)

Remarks

The following types of object expose IMFShutdown:

Any component that creates one of these objects is responsible for calling Shutdown on the object before releasing the object. Typically, applications do not create any of these objects directly, so it is not usually necessary to use this interface in an application.

To obtain a pointer to this interface, call QueryInterface on the object.

If you are implementing a custom object, your object can expose this interface, but only if you can guarantee that your application will call Shutdown.

Media sources, media sinks, and synchronous MFTs should not implement this interface, because the Media Foundation pipeline will not call Shutdown on these objects. Asynchronous MFTs must implement this interface.

This interface is not related to the MFShutdown function, which shuts down the Media Foundation platform, as described in Initializing Media Foundation.

Some Media Foundation interfaces define a Shutdown method, which serves the same purpose as IMFShutdown::Shutdown but is not directly related to it.

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 mfidl.h

See also

MFShutdownObject

Media Foundation Interfaces