VMRRenderPrefs-Enumeration (strmif.h)

Artikel
03/02/2024

[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.]

Der VMRenderPrefs-Enumerationstyp wird mit den Methoden IVMRFilterConfig::GetRenderingPrefs und IVMRFilterConfig::SetRenderingPrefs verwendet, um grundlegende Renderingeinstellungen abzurufen und festzulegen.

Syntax

typedef enum VMRRenderPrefs {
  RenderPrefs_RestrictToInitialMonitor = 0,
  RenderPrefs_ForceOffscreen = 0x1,
  RenderPrefs_ForceOverlays = 0x2,
  RenderPrefs_AllowOverlays = 0,
  RenderPrefs_AllowOffscreen = 0,
  RenderPrefs_DoNotRenderColorKeyAndBorder = 0x8,
  RenderPrefs_Reserved = 0x10,
  RenderPrefs_PreferAGPMemWhenMixing = 0x20,
  RenderPrefs_Mask = 0x3f
} ;

Konstanten


`RenderPrefs_RestrictToInitialMonitor` Wert: 0 Nicht implementiert; nicht verwenden.
`RenderPrefs_ForceOffscreen` Wert: 0x1 Gibt an, dass der Video mixing Renderer Filter 7 (VMR-7) nur Offscreen-Oberflächen zum Rendern verwenden sollte.
`RenderPrefs_ForceOverlays` Wert: 0x2 Gibt an, dass VMR-7 fehlschlagen sollte, wenn keine Überlagerungsflächen verfügbar sind.
`RenderPrefs_AllowOverlays` Wert: 0 Gibt an, dass die VMR-7 Überlagerungen verwenden soll, wenn sie verfügbar sind. Sollte nicht von neuen Anwendungen verwendet werden.
`RenderPrefs_AllowOffscreen` Wert: 0 Gibt an, dass VMR-7 Offscreen-Oberflächen verwenden sollte, wenn keine Überlagerungen verfügbar sind. Sollte nicht von neuen Anwendungen verwendet werden.
`RenderPrefs_DoNotRenderColorKeyAndBorder` Wert: 0x8 Gibt an, dass die Anwendung für das Malen der Farbtasten verantwortlich ist.
`RenderPrefs_Reserved` Wert: 0x10 Reserviert; nicht verwenden.
`RenderPrefs_PreferAGPMemWhenMixing` Wert: 0x20 Gibt an, dass VMR-7 versuchen sollte, AGP-Arbeitsspeicher beim Zuweisen von Texturoberflächen zu verwenden.
`RenderPrefs_Mask` Wert: 0x3f Bitweise OR aller oben genannten Flags.

Hinweise

Standardmäßig versucht VMR-7, DirectDraw-Texturoberflächen aus Dem Videospeicher zuzuweisen, und greift auf den AGP-Arbeitsspeicher zurück, wenn kein Videospeicher vorhanden ist, um die Zuordnung zu erfüllen. Damit der VMR-7 AGP-Arbeitsspeicher verwenden kann, muss die Grafik-Karte eine grundlegende Unterstützung für die Abschneidung vom AGP-Speicher in den Videospeicher aufweisen.

Anforderungen

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

Weitere Informationen

DirectShow Enumerated Types

Freigeben über