MFCreateVideoRendererActivate-Funktion (mfidl.h)
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 |
|---|---|
|
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 |