IMFActivate::ShutdownObject-Methode (mfobjects.h)

Beendet das erstellte Objekt.

Syntax

HRESULT ShutdownObject();

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.

Hinweise

Wenn Sie ein Objekt durch Aufrufen von IMFActivate::ActivateObject erstellen, rufen Sie ShutdownObject auf, wenn Sie mit der Verwendung des Objekts fertig sind.

Die Komponente, die ActivateObject aufruft – nicht die Komponente, die das Aktivierungsobjekt erstellt – ist für den Aufruf von ShutdownObject verantwortlich. In einer typischen Wiedergabeanwendung erstellt die Anwendung beispielsweise Aktivierungsobjekte für die Mediensenken, aber die Mediensitzung ruft ActivateObject auf. Daher ruft die Mediensitzung, nicht die Anwendung, ShutdownObject auf.

Nachdem ShutdownObject aufgerufen wurde, gibt das Aktivierungsobjekt alle seine internen Verweise auf das erstellte Objekt frei. Wenn Sie ActivateObject erneut aufrufen, erstellt das Aktivierungsobjekt eine neue instance des anderen Objekts.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfobjects.h
Bibliothek	Mfuuid.lib

Weitere Informationen

Aktivierungsobjekte

IMFAktivieren