IVMRFilterConfig::SetRenderingMode-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die SetRenderingMode -Methode legt den von der VMR verwendeten Renderingmodus fest.

Syntax

HRESULT SetRenderingMode(
  [in] DWORD Mode
);

Parameter

[in] Mode

Gibt den Renderingmodus als VMRMode-Wert an.

Rückgabewert

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

Rückgabecode	Beschreibung
E_INVALIDARG	Es wurde ein ungültiger Renderingmodus angegeben.
VFW_E_WRONG_STATE	Der Modus kann aus irgendeinem Grund nicht geändert werden. Siehe Hinweise.

Hinweise

Die VMR befindet sich standardmäßig in VMRMode_Windowed . Verwenden Sie diese Methode nur, wenn Sie die VMR in VMRMode_Windowless oder VMRMode_Renderless Modus versetzen. Sie können den Modus nicht ändern, nachdem eine Stecknadel verbunden wurde, und Sie können den Modus nicht von fensterlos oder renderlos zurück in fensterlos ändern, auch bevor Pins verbunden sind. Daher hat die Angabe VMRMode_Windowed für Mode unter keinen Umständen Auswirkungen.

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::GetRenderingMode

Verwenden des Videomischrenderers