MFCreateVideoRendererActivate-Funktion (mfidl.h)

  • Artikel

Erstellt ein Aktivierungsobjekt für die EVR-Mediensenke (Enhanced Video Renderer).

Syntax

HRESULT MFCreateVideoRendererActivate(
  [in]  HWND        hwndVideo,
  [out] IMFActivate **ppActivate
);

Parameter

[in] hwndVideo

Handle zum Fenster, in dem das Video angezeigt wird.

[out] ppActivate

Empfängt einen Zeiger auf die IMFActivate-Schnittstelle . Verwenden Sie diese Schnittstelle, um den EVR zu erstellen. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Funktion 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

Um den EVR zu erstellen, rufen Sie IMFActivate::ActivateObject für den abgerufenen IMFActivate-Zeiger auf . (Wenn Sie die Mediensitzung verwenden, ruft die Mediensitzung automatisch ActivateObject auf , wenn Sie die Topologie in die Warteschlange stellen.)

Legen Sie zum Konfigurieren des EVR eines der folgenden Attribute für das IMFActivate-Objekt fest, bevor Sie ActivateObject aufrufen.

attribute BESCHREIBUNG
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_ACTIVATE Aktivierungsobjekt für einen benutzerdefinierten Mixer.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_CLSID CLSID für einen benutzerdefinierten Mixer.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_FLAGS Flags zum Erstellen eines benutzerdefinierten Mixers.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_ACTIVATE Aktivierungsobjekt für einen benutzerdefinierten Referenten.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_CLSID CLSID für einen benutzerdefinierten Referenten.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_FLAGS Flags zum Erstellen eines benutzerdefinierten Referenten.
 

Wenn IMFActivate::ActivateObject aufgerufen wird, legen die Aktivierungsobjekte das Videofenster im EVR durch Aufrufen von IMFVideoDisplayControl::SetVideoPosition fest. Das Übergeben von NULL für den hwndVideo-Parameter ist kein Fehler, aber es wird kein Video gerendert, es sei denn, das EVR verfügt über ein gültiges Videofenster.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mf.lib
DLL Mf.dll

Weitere Informationen

Aktivierungsobjekte

Erweiterter Videorenderer

Media Foundation-Funktionen