Enumerazione VMRSurfaceAllocationFlags (strmif.h)

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'enumerazione VMRSurfaceAllocationFlags viene usata con il metodo IVMRSurfaceAllocator::AllocateSurface per specificare i parametri di creazione della superficie.

Sintassi

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
} ;

Costanti


`AMAP_PIXELFORMAT_VALID` Valore: 0x1 Indica che il campo lpPxFmt contiene dati validi che devono essere usati per creare la superficie DirectDraw.
`AMAP_3D_TARGET` Valore: 0x2 Indica che la superficie DirectDraw creata deve essere anche una destinazione di rendering Direct3D creata con il set di flag DDSCAPS_3DDEVICE .
`AMAP_ALLOW_SYSMEM` Valore: 0x4 Indica che se non è possibile allocare la superficie DirectDraw in memoria video, si tenterà di allocare una superficie DirectDraw della memoria di sistema. Si noti che non è mai necessario allocare una superficie di memoria AGP.
`AMAP_FORCE_SYSMEM` Valore: 0x8 Forzare la creazione della superficie nella memoria di sistema. Specificare questa opzione se si userà GDI per elaborare l'immagine prima del rendering. La superficie deve corrispondere al formato di visualizzazione del monitor corrente (profondità pixel).
`AMAP_DIRECTED_FLIP` Valore: 0x10 Significa che quando Flip viene chiamato è necessario passare a DirectDraw Surface specificato passato come parametro al metodo PresentImage nell'interfaccia IVMRImagePresenter . Il supporto corretto per questo flag è fondamentale per mantenere i buffer DXVA visualizzati da un decodificatore video sincronizzato con i buffer DXVA visti dal driver grafico.
`AMAP_DXVA_TARGET` Valore: 0x20 Indica che questa superficie verrà usata come destinazione DXVA.

Commenti

AMAP_3D_TARGET non può essere combinato con AMAP_FORCE_SYSMEM o AMAP_ALLOW_SYSMEM perché le superfici 3D non possono essere create nella memoria di sistema.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	strmif.h (include Dshow.h)

Vedi anche

Tipi enumerati DirectShow

IVMRSurfaceAllocator::AllocateSurface

Condividi tramite