Função ICDrawBegin (vfw.h)
A função ICDrawBegin inicializa o renderizador e prepara o destino de desenho para desenho.
Sintaxe
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
Manipule para o descompactador a ser usado.
dwFlags
Sinalizadores de descompactação. Os valores a seguir são definidos.
| Valor | Significado |
|---|---|
| ICDRAW_ANIMATE | O aplicativo pode animar a paleta. |
| ICDRAW_CONTINUE | O desenho é uma continuação do quadro anterior. |
| ICDRAW_FULLSCREEN | Desenha os dados descompactados na tela inteira. |
| ICDRAW_HDC | Desenha os dados descompactados em uma janela ou dc. |
| ICDRAW_MEMORYDC | O DC está fora da tela. |
| ICDRAW_QUERY | Determina se o descompactador pode descompactar os dados. O driver não descompacta os dados. |
| ICDRAW_UPDATING | O quadro atual está sendo atualizado em vez de reproduzido. |
hpal
Manipule para a paleta usada para desenhar.
hwnd
Identificador para a janela usada para desenhar.
hdc
DC usado para desenhar.
xDst
A coordenada x do canto superior direito do retângulo de destino.
yDst
A coordenada y do canto superior direito do retângulo de destino.
dxDst
Largura do retângulo de destino.
dyDst
Altura do retângulo de destino.
lpbi
Ponteiro para uma estrutura BITMAPINFOHEADER que contém o formato dos dados de entrada a serem descompactados.
xSrc
A coordenada x do canto superior direito do retângulo de origem.
ySrc
A coordenada y do canto superior direito do retângulo de origem.
dxSrc
Largura do retângulo de origem.
dySrc
Altura do retângulo de origem.
dwRate
Numerador de taxa de quadros. A taxa de quadros, em quadros por segundo, é obtida dividindo dwRate por dwScale.
dwScale
Denominador de taxa de quadros. A taxa de quadros, em quadros por segundo, é obtida dividindo dwRate por dwScale.
Retornar valor
Retorna ICERR_OK se o renderizador puder descompactar os dados ou ICERR_UNSUPPORTED caso contrário.
Comentários
Os sinalizadores ICDRAW_HDC e ICDRAW_FULLSCREEN são mutuamente exclusivos. Se um aplicativo definir o sinalizador ICDRAW_HDC em dwFlags, o descompactador usará hwnd, hdc e os parâmetros que definem o retângulo de destino (xDst, yDst, dxDst e dyDst). Seu aplicativo deve definir esses parâmetros para o tamanho do retângulo de destino. Especifique valores de retângulo de destino em relação à janela atual ou dc.
Se um aplicativo definir o sinalizador ICDRAW_FULLSCREEN em dwFlags, os parâmetros hwnd e hdc não serão usados e deverão ser definidos como NULL. Além disso, o retângulo de destino não é usado e seus parâmetros podem ser definidos como zero.
O retângulo de origem é relativo ao quadro de vídeo completo. A parte do quadro de vídeo especificada pelo retângulo de origem é alongada ou reduzida para caber no retângulo de destino.
Os parâmetros dwRate e dwScale especificam a taxa de descompactação. O valor inteiro especificado para dwRate dividido pelo valor inteiro especificado para dwScale define a taxa de quadros em quadros por segundo. Esse valor é usado pelo renderizador quando ele é responsável por quadros de tempo durante a reprodução.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vfw.h |
| Biblioteca | Vfw32.lib |
| DLL | Msvfw32.dll |