Función ICDrawBegin (vfw.h)

La función ICDrawBegin inicializa el representador y prepara el destino del dibujo para dibujar.

Sintaxis

DWORD VFWAPIV ICDrawBegin(
  HIC                hic,
  DWORD              dwFlags,
  HPALETTE           hpal,
  HWND               hwnd,
  HDC                hdc,
  int                xDst,
  int                yDst,
  int                dxDst,
  int                dyDst,
  LPBITMAPINFOHEADER lpbi,
  int                xSrc,
  int                ySrc,
  int                dxSrc,
  int                dySrc,
  DWORD              dwRate,
  DWORD              dwScale
);

Parámetros

hic

Identificador del descomprimor que se va a usar.

dwFlags

Marcas de descompresión. Se definen los valores siguientes.

Valor	Significado
ICDRAW_ANIMATE	La aplicación puede animar la paleta.
ICDRAW_CONTINUE	El dibujo es una continuación del marco anterior.
ICDRAW_FULLSCREEN	Dibuja los datos descomprimidos en la pantalla completa.
ICDRAW_HDC	Dibuja los datos descomprimidos en una ventana o un controlador de dominio.
ICDRAW_MEMORYDC	El controlador de dominio está fuera de pantalla.
ICDRAW_QUERY	Determina si el descompresor puede descomprimir los datos. El controlador no descomprime los datos.
ICDRAW_UPDATING	El fotograma actual se está actualizando en lugar de reproducirse.

hpal

Identificador de la paleta usada para dibujar.

hwnd

Identificador de la ventana utilizada para dibujar.

hdc

DC usado para dibujar.

xDst

Coordenada x de la esquina superior derecha del rectángulo de destino.

yDst

Coordenada y de la esquina superior derecha del rectángulo de destino.

dxDst

Ancho del rectángulo de destino.

dyDst

Alto del rectángulo de destino.

lpbi

Puntero a una estructura BITMAPINFOHEADER que contiene el formato de los datos de entrada que se van a descomprimir.

xSrc

Coordenada x de la esquina superior derecha del rectángulo de origen.

ySrc

Coordenada y de la esquina superior derecha del rectángulo de origen.

dxSrc

Ancho del rectángulo de origen.

dySrc

Alto del rectángulo de origen.

dwRate

Numerador de velocidad de fotogramas. La velocidad de fotogramas, en fotogramas por segundo, se obtiene dividiendo dwRate por dwScale.

dwScale

Denominador de velocidad de fotogramas. La velocidad de fotogramas, en fotogramas por segundo, se obtiene dividiendo dwRate por dwScale.

Valor devuelto

Devuelve ICERR_OK si el representador puede descomprimir los datos o ICERR_UNSUPPORTED de lo contrario.

Comentarios

Las marcas ICDRAW_HDC y ICDRAW_FULLSCREEN son mutuamente excluyentes. Si una aplicación establece la marca ICDRAW_HDC en dwFlags, el descomprimor usa hwnd, hdc y los parámetros que definen el rectángulo de destino (xDst, yDst, dxDst y dyDst). La aplicación debe establecer estos parámetros en el tamaño del rectángulo de destino. Especifique los valores del rectángulo de destino relativos a la ventana o dc actual.

Si una aplicación establece la marca ICDRAW_FULLSCREEN en dwFlags, no se usan los parámetros hwnd y hdc y deben establecerse en NULL. Además, el rectángulo de destino no se usa y sus parámetros se pueden establecer en cero.

El rectángulo de origen es relativo al fotograma de vídeo completo. La parte del fotograma de vídeo especificado por el rectángulo de origen se extiende o se reduce para ajustarse al rectángulo de destino.

Los parámetros dwRate y dwScale especifican la tasa de descompresión. El valor entero especificado para dwRate dividido por el valor entero especificado para dwScale define la velocidad de fotogramas en fotogramas por segundo. El representador usa este valor cuando es responsable de los fotogramas de control de tiempo durante la reproducción.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vfw.h
Library	Vfw32.lib
Archivo DLL	Msvfw32.dll

Consulte también

Funciones de compresión de vídeo

Administrador de compresión de vídeo