Structure VMRALPHABITMAP (strmif.h)

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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.]

La structure VMRALPHABITMAP est utilisée dans les méthodes IVMRMixerBitmap du filtre VMR-7 lorsque l’application fournit une image bitmap statique à mélange alpha à afficher sur l’image vidéo composite.

Syntaxe

typedef struct _VMRALPHABITMAP {
  DWORD                dwFlags;
  HDC                  hdc;
  LPDIRECTDRAWSURFACE7 pDDS;
  RECT                 rSrc;
  NORMALIZEDRECT       rDest;
  FLOAT                fAlpha;
  COLORREF             clrSrcKey;
} VMRALPHABITMAP, *PVMRALPHABITMAP;

Membres

dwFlags

Indicateurs qui indiquent au mélangeur où trouver l’image bitmap. Les valeurs suivantes sont définies.

Valeur Signification
VMRBITMAP_DISABLE
0x00000001
 Désactivez l’image bitmap. Cet indicateur ne peut pas être combiné avec d’autres indicateurs.
VMRBITMAP_HDC
0x00000002
 Obtenez l’image bitmap à partir du HDC. Si cet indicateur est défini, le membre hdc doit spécifier un handle valide pour un contexte d’appareil, et le membre pDDS doit avoir la valeur NULL.

Si cet indicateur est absent, le membre pDDS doit pointer vers une surface DirectDraw valide et le membre hdc doit avoir la valeur NULL.
VMRBITMAP_ENTIREDDS
0x00000004
 Prenez l’ensemble de la surface DirectDraw. Lorsque cet indicateur est spécifié, rSrc est ignoré. Cet indicateur ne peut pas être combiné avec l’indicateur VMRBITMAP_HDC .
VMRBITMAP_SRCCOLORKEY
0x00000008
 La valeur clrSrcKey est valide et doit être utilisée lors de la fusion.
VMRBITMAP_SRCRECT
0x00000010
 Indique que le rectangle rSrc est valide et spécifie un sous-rectangle de l’image d’application d’origine à fusionner.

Cet indicateur est valide uniquement pour la méthode IVMRMixerBitmap ::UpdateAlphaBitmapParameters . Pour la méthode IVMRMixerBitmap ::SetAlphaBitmap , le membre rSrc doit faire référence à l’intégralité de l’image bitmap.

hdc

Handle du contexte de l’appareil pour l’image bitmap. Spécifiez NULL si l’image bitmap se trouve dans une surface DirectDraw.

pDDS

Pointeur vers une surface DirectDraw qui contient l’image bitmap. Spécifiez NULL si l’image bitmap doit être obtenue à partir d’un contexte d’appareil GDI. Si une surface DirectDraw est spécifiée, le format de pixel doit être ARGB-32 ou RVB-32. Si la surface contient l’alpha par pixel, ne définissez pas l’indicateur VMRBITMAP_SRCCOLORKEY dans dwFlags.

rSrc

Spécifie le rectangle source dans le contexte de l’appareil GDI ou dans la surface DirectDraw.

rDest

Spécifie le rectangle de destination dans l’espace de composition.

fAlpha

Spécifie la valeur de fusion alpha ; doit être une valeur comprise entre 0,0 et 1,0 (inclus).

clrSrcKey

Spécifie la clé de couleur source.

Configuration requise

Condition requise Valeur
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

DirectShow Structures