IVMRFilterConfig::SetRenderingPrefs-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SetRenderingPrefs -Methode legt verschiedene Anwendungseinstellungen für das Videorendering fest.

Syntax

HRESULT SetRenderingPrefs(
  [in] DWORD dwRenderFlags
);

Parameter

[in] dwRenderFlags

Doppeltes Wort, das ein bitweises ODER von VMRRenderPrefs-Werten enthält, die die Renderingeinstellungen angeben.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
VFW_E_WRONG_STATE	Es ist kein Zuteilungs-Referenten vorhanden.
E_INVALIDARG	dwRenderFlags ist ungültig.

Hinweise

Diese Methode ruft die IVMRImagePresenterConfig::SetRenderingPrefs-Methode des allocator-presenters auf. (Der Standardzuweisungs-Presenter macht IVMRImagePresenterConfig verfügbar. Benutzerdefinierte Zuteilungs-Referenten können diese Schnittstelle auch verfügbar machen, wenn dies gewünscht ist.) Wenn VMR-7 den Standardzuweisungs-Presenter noch nicht erstellt hat oder die Anwendung einen benutzerdefinierten Zuteilungs-Presenter bereitgestellt hat, der IVMRImagePresenterConfig nicht unterstützt, gibt diese Methode VFW_E_WRONG_STATE zurück. Um den Standardzuteilungs-Presenter zu erstellen, rufen Sie IVMRFilterConfig::SetRenderingMode mit dem Wert VMRMode_Windowed oder VMRMode_Windowed auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IVMRFilterConfig-Schnittstelle

IVMRFilterConfig::GetRenderingPrefs

Verwenden des Videomischrenderers