IVMRMixerBitmap::SetAlphaBitmap

 
Microsoft DirectShow 9.0

IVMRMixerBitmap::SetAlphaBitmap

The SetAlphaBitmap method specifies a new bitmap image and the source location of the bitmap and how and where it should be rendered on the destination rectangle.

Syntax

  HRESULT SetAlphaBitmap(

  
  const VMRALPHABITMAP*
  
  pBmpParms

  );

Parameters

pBmpParms

[in]  Pointer to a VMRALPHABITMAP structure that contains information about the bitmap.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Error Code Description
E_POINTER pBmpParms is NULL.
E_INVALIDARG Indicates a problem with the dwFlags member of the VMRALPHABITMAP structure or failure to specify a valid HDC or DirectDraw surface in the structure, or an invalid value for fAlpha.
E_OUTOFMEMORY Could not create a destination DC or DIBSection for the bitmap.
E_FAIL BitBlt to bitmap surface failed.

Remarks

To remove the bitmap, set the VMRBITMAP_DISABLE flag in the VMRALPHABITMAP structure and call SetAlphaBitmap again.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also