Funzione ICDrawBegin (vfw.h)

La funzione ICDrawBegin inizializza il renderer e prepara la destinazione di disegno per il disegno.

Sintassi

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
);

Parametri

hic

Gestire il decompressore da usare.

dwFlags

Flag di decompressione. I valori seguenti sono definiti.

Valore	Significato
ICDRAW_ANIMATE	L'applicazione può animare la tavolozza.
ICDRAW_CONTINUE	Il disegno è una continuazione della cornice precedente.
ICDRAW_FULLSCREEN	Disegna i dati decompressi sullo schermo intero.
ICDRAW_HDC	Disegna i dati decompressi in una finestra o in un controller di dominio.
ICDRAW_MEMORYDC	DC è fuori schermo.
ICDRAW_QUERY	Determina se il decompressore può decomprimere i dati. Il driver non decompresse i dati.
ICDRAW_UPDATING	Il frame corrente viene aggiornato anziché riprodotto.

hpal

Handle nella tavolozza utilizzata per il disegno.

hwnd

Handle nella finestra usata per il disegno.

hdc

DC usato per il disegno.

xDst

Coordinata x dell'angolo superiore destro del rettangolo di destinazione.

yDst

Coordinata y dell'angolo superiore destro del rettangolo di destinazione.

dxDst

Larghezza del rettangolo di destinazione.

dyDst

Altezza del rettangolo di destinazione.

lpbi

Puntatore a una struttura BITMAPINFOHEADER contenente il formato dei dati di input da decomprimere.

xSrc

Coordinata x dell'angolo superiore destro del rettangolo di origine.

ySrc

Coordinata y dell'angolo superiore destro del rettangolo di origine.

dxSrc

Larghezza del rettangolo di origine.

dySrc

Altezza del rettangolo di origine.

dwRate

Numeratore della frequenza dei fotogrammi. La frequenza dei fotogrammi, in fotogrammi al secondo, viene ottenuta suddividendo dwRate da dwScale.

dwScale

Denominatore della frequenza dei fotogrammi. La frequenza dei fotogrammi, in fotogrammi al secondo, viene ottenuta suddividendo dwRate da dwScale.

Valore restituito

Restituisce ICERR_OK se il renderer può decomprimere i dati o ICERR_UNSUPPORTED in caso contrario.

Commenti

I flag ICDRAW_HDC e ICDRAW_FULLSCREEN si escludono a vicenda. Se un'applicazione imposta il flag di ICDRAW_HDC in dwFlags, il decompressore usa hwnd, hdc e i parametri che definiscono il rettangolo di destinazione (xDst, yDst, dxDst e dyDst). L'applicazione deve impostare questi parametri sulle dimensioni del rettangolo di destinazione. Specificare i valori del rettangolo di destinazione relativi alla finestra corrente o al controller di dominio corrente.

Se un'applicazione imposta il flag ICDRAW_FULLSCREEN in dwFlags, i parametri hwnd e hdc non vengono usati e devono essere impostati su NULL. Inoltre, il rettangolo di destinazione non viene usato e i relativi parametri possono essere impostati su zero.

Il rettangolo di origine è relativo al fotogramma video completo. La parte del fotogramma video specificato dal rettangolo di origine è estesa o ridimensionata per adattare il rettangolo di destinazione.

I parametri dwRate e dwScale specificano la frequenza di decompressione. Il valore integer specificato per dwRate diviso per il valore intero specificato per dwScale definisce la frequenza dei fotogrammi nei fotogrammi al secondo. Questo valore viene usato dal renderer quando è responsabile dei fotogrammi di intervallo durante la riproduzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vfw.h
Libreria	Vfw32.lib
DLL	Msvfw32.dll

Vedi anche

Funzioni di compressione video

Gestione compressione video