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 |
|---|---|
|
Es wurde ein ungültiger Renderingmodus angegeben. |
|
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
IVMRFilterConfig-Schnittstelle