Freigeben über


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:

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