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 |