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

Confira também

Funções de compactação de vídeo

Gerenciador de Compactação de Vídeo