Estrutura VMRALPHABITMAP (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A estrutura VMRALPHABITMAP é usada nos métodos IVMRMixerBitmap do filtro VMR-7 quando o aplicativo está fornecendo um bitmap de mistura alfa estática a ser exibido no quadro de vídeo composto.

Sintaxe

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

Membros

dwFlags

Sinalizadores que instruem o mixer onde encontrar o bitmap. Os valores a seguir são definidos.

Valor Significado
VMRBITMAP_DISABLE
0x00000001
 Desabilite o bitmap. Esse sinalizador não pode ser combinado com outros sinalizadores.
VMRBITMAP_HDC
0x00000002
 Obtenha o bitmap do HDC. Se esse sinalizador estiver definido, o membro hdc deverá especificar um identificador válido para um contexto de dispositivo e o membro pDDS deverá ser NULL.

Se esse sinalizador estiver ausente, o membro pDDS deverá apontar para uma superfície DirectDraw válida e o membro hdc deverá ser NULL.
VMRBITMAP_ENTIREDDS
0x00000004
 Pegue toda a superfície do DirectDraw. Quando esse sinalizador é especificado, rSrc é ignorado. Esse sinalizador não pode ser combinado com o sinalizador VMRBITMAP_HDC .
VMRBITMAP_SRCCOLORKEY
0x00000008
 O valor clrSrcKey é válido e deve ser usado durante a mesclagem.
VMRBITMAP_SRCRECT
0x00000010
 Indica que o retângulo rSrc é válido e especifica um subtângulo da imagem original do aplicativo a ser combinada.

Esse sinalizador só é válido para o método IVMRMixerBitmap::UpdateAlphaBitmapParameters . Para o método IVMRMixerBitmap::SetAlphaBitmap , o membro rSrc deve se referir a todo o bitmap.

hdc

O identificador para o contexto do dispositivo para o bitmap. Especifique NULL se o bitmap estiver localizado em uma superfície DirectDraw.

pDDS

Ponteiro para uma superfície DirectDraw que contém o bitmap. Especifique NULL se o bitmap for obtido de um contexto de dispositivo GDI. Se uma superfície DirectDraw for especificada, o formato de pixel deverá ser ARGB-32 ou RGB-32. Se a superfície contiver alfa por pixel, não defina o sinalizador VMRBITMAP_SRCCOLORKEY em dwFlags.

rSrc

Especifica o retângulo de origem no contexto do dispositivo GDI ou na superfície DirectDraw.

rDest

Especifica o retângulo de destino no espaço de composição.

fAlpha

Especifica o valor de mesclagem alfa; deve ser um valor de 0,0 a 1,0 (inclusive).

clrSrcKey

Especifica a chave de cor de origem.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho strmif.h (inclua Dshow.h)

Confira também

Estruturas do DirectShow