VMRRenderPrefs-Enumeration (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.]

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