Método IVMRMixerBitmap::SetAlphaBitmap (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El método SetAlphaBitmap especifica una nueva imagen de mapa de bits y la ubicación de origen del mapa de bits y cómo y dónde se debe representar en el rectángulo de destino.
Sintaxis
HRESULT SetAlphaBitmap(
[in] const VMRALPHABITMAP *pBmpParms
);
Parámetros
[in] pBmpParms
Puntero a una estructura VMRALPHABITMAP que contiene información sobre el mapa de bits.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.
| Código devuelto | Descripción |
|---|---|
|
pBmpParms es NULL. |
|
Argumento no válido. Vea la sección Comentarios. |
|
No se pudo crear un controlador de dominio o DIBSection de destino para el mapa de bits. |
|
Error de bitBlt a la superficie de mapa de bits. |
Observaciones
Para quitar el mapa de bits, establezca la estructura VMRALPHABITMAP y vuelva a llamar a SetAlphaBitmap .
El método puede devolver E_INVALIDARG por varias razones:
-
[VMRALPHABITMAP] La estructura (/windows/desktop/api/strmif/ns-strmif-vmralphabitmap) contiene una combinación no válida de marcas.
[VMRALPHABITMAP] (/windows/desktop/api/strmif/ns-strmif-vmralphabitmap) estructura no especifica una superficie HDC o DirectDraw válida.
- El valor de fAlpha no es válido.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluya Dshow.h) |
| Library | Strmiids.lib |
Consulte también
IVMRMixerBitmap::GetAlphaBitmapParameters