IMFShutdown interface

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

Members

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

Methods

The IMFShutdown interface has these methods.

MethodDescription
GetShutdownStatus

Queries the status of a prior call to the Shutdown method.

Shutdown

Shuts down a Media Foundation object and releases all resources associated with the object.

 

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

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

Mfidl.h

Library

Mfuuid.lib

See also

Media Foundation Interfaces
MFShutdownObject

 

 

Show: