IMFActivate::ActivateObject-Methode (mfobjects.h)

Erstellt das diesem Aktivierungsobjekt zugeordnete Objekt.

Syntax

HRESULT ActivateObject(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] riid

Schnittstellenbezeichner (IID) der angeforderten Schnittstelle.

[out] ppv

Empfängt einen Zeiger auf die angeforderte Schnittstelle. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Einige Microsoft Media Foundation-Objekte müssen vor der Veröffentlichung heruntergefahren werden. Wenn dies der Grund ist, ist der Aufrufer für das Herunterfahren des Objekts verantwortlich, das in ppv zurückgegeben wird. Führen Sie eine der folgenden Aktionen aus, um das -Objekt herunterzufahren:

• Rufen Sie IMFActivate::ShutdownObject für das Aktivierungsobjekt auf, oder
• Rufen Sie die objektspezifische Shutdown-Methode auf. Diese Methode hängt vom Typ des Objekts ab. Dies können unter anderem folgende sein:
  • Medienquellen: Rufen Sie IMFMediaSource::Shutdown auf.
  • Mediensenken: Rufen Sie IMFMediaSink::Shutdown auf.
  • Jedes Objekt, das die IMFShutdown-Schnittstelle unterstützt: Aufrufen von IMFShutdown::Shutdown.

Die IMFActivate::ShutdownObject-Methode ist für alle Objekttypen generisch. Wenn das Objekt keine Shutdown-Methode erfordert, ist ShutdownObject erfolgreich und hat keine Auswirkung. Wenn Sie die spezifische Herunterfahrmethode für das Objekt nicht kennen (oder den Objekttyp nicht kennen), rufen Sie IMFActivate::ShutdownObject auf.

Nach dem ersten Aufruf von ActivateObject geben nachfolgende Aufrufe einen Zeiger auf dieselbe instance zurück, bis der Client ShutdownObject oder IMFActivate::D etachObject aufruft.

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