Énumération VMRSurfaceAllocationFlags (strmif.h)

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’énumération VMRSurfaceAllocationFlags est utilisée avec la méthode IVMRSurfaceAllocator::AllocateSurface pour spécifier les paramètres de création de surface.

Syntaxe

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

Constantes


`AMAP_PIXELFORMAT_VALID` Valeur : 0x1 Indique que le champ lpPxFmt contient des données valides qui doivent être utilisées pour créer la surface DirectDraw.
`AMAP_3D_TARGET` Valeur : 0x2 Indique que la surface DirectDraw créée doit également être une cible de rendu Direct3D créée avec l’indicateur DDSCAPS_3DDEVICE défini.
`AMAP_ALLOW_SYSMEM` Valeur : 0x4 Indique que si vous ne pouvez pas allouer la surface DirectDraw en mémoire vidéo, vous allez essayer d’allouer une surface DirectDraw de mémoire système. (Notez que vous ne devez jamais allouer une surface mémoire AGP.)
`AMAP_FORCE_SYSMEM` Valeur : 0x8 Forcer la création de la surface dans la mémoire système. Spécifiez cette valeur si vous allez utiliser GDI pour traiter l’image avant qu’elle ne soit rendue. La surface doit correspondre au format d’affichage actuel du moniteur (profondeur de pixels).
`AMAP_DIRECTED_FLIP` Valeur : 0x10 Signifie que lorsque Flip est appelé, vous devez retourner vers la Surface DirectDraw spécifiée passée en tant que paramètre à la méthode PresentImage dans l’interface IVMRImagePresenter . La prise en charge correcte de cet indicateur est essentielle pour que les mémoires tampons DXVA visibles par un décodeur vidéo soient synchronisées avec les mémoires tampons DXVA vues par le pilote graphique.
`AMAP_DXVA_TARGET` Valeur : 0x20 Indique que cette surface sera utilisée comme cible DXVA.

Notes

AMAP_3D_TARGET ne peut pas être combiné avec AMAP_FORCE_SYSMEM ou AMAP_ALLOW_SYSMEM, car les surfaces 3D ne peuvent pas être créées dans la mémoire système.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	strmif.h (include Dshow.h)

Voir aussi

Types énumérés DirectShow

IVMRSurfaceAllocator::AllocateSurface

Partager via