VMRSurfaceAllocationFlags-Enumeration (strmif.h)

Artikel
07/28/2023

[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 VMRSurfaceAllocationFlags-Enumeration wird zusammen mit der IVMRSurfaceAllocator::AllocateSurface-Methode verwendet, um Oberflächenerstellungsparameter anzugeben.

Syntax

typedef enum VMRSurfaceAllocationFlags {
  AMAP_PIXELFORMAT_VALID = 0x1,
  AMAP_3D_TARGET = 0x2,
  AMAP_ALLOW_SYSMEM = 0x4,
  AMAP_FORCE_SYSMEM = 0x8,
  AMAP_DIRECTED_FLIP = 0x10,
  AMAP_DXVA_TARGET = 0x20
} ;

Konstanten


`AMAP_PIXELFORMAT_VALID` Wert: 0x1 Gibt an, dass das LpPxFmt-Feld gültige Daten enthält, die zum Erstellen der DirectDraw-Oberfläche verwendet werden sollen.
`AMAP_3D_TARGET` Wert: 0x2 Gibt an, dass die erstellte DirectDraw-Oberfläche auch ein Direct3D-Renderziel sein soll, das mit festgelegtem DDSCAPS_3DDEVICE-Flag erstellt wird.
`AMAP_ALLOW_SYSMEM` Wert: 0x4 Gibt an, dass Sie, wenn Sie die DirectDraw-Oberfläche nicht im Videospeicher zuordnen können, versuchen, eine DirectDraw-Systemspeicheroberfläche zuzuweisen. (Beachten Sie, dass Sie niemals eine AGP-Speicheroberfläche zuordnen sollten.)
`AMAP_FORCE_SYSMEM` Wert: 0x8 Erzwingen, dass die Oberfläche im Systemspeicher erstellt wird. Geben Sie dies an, wenn Sie GDI verwenden, um das Image zu verarbeiten, bevor es gerendert wird. Die Oberfläche muss mit dem aktuellen Bildschirmanzeigeformat (Pixeltiefe) übereinstimmen.
`AMAP_DIRECTED_FLIP` Wert: 0x10 Bedeutet, dass beim Aufrufen von Flip auf die angegebene DirectDraw Surface-Schnittstelle als Parameter an die PresentImage-Methode in der IVMRImagePresenter-Schnittstelle übergeben werden soll. Die richtige Unterstützung für dieses Flag ist wichtig, um DXVA-Puffer, die von einem Videodecoder erkannt werden, mit den DXVA-Puffern zu synchronisieren, die vom Grafiktreiber erkannt werden.
`AMAP_DXVA_TARGET` Wert: 0x20 Gibt an, dass diese Oberfläche als DXVA-Ziel verwendet wird.

Bemerkungen

AMAP_3D_TARGET können nicht mit AMAP_FORCE_SYSMEM oder AMAP_ALLOW_SYSMEM kombiniert werden, da 3D-Oberflächen nicht im Systemspeicher erstellt werden können.

Anforderungen


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)

Siehe auch

DirectShow Enumerated Types

IVMRSurfaceAllocator::AllocateSurface

Freigeben über