Funzione ICDecompressEx (vfw.h)

La funzione ICDecompressEx decomprime un singolo fotogramma video.

Sintassi

LRESULT VFWAPI_INLINE ICDecompressEx(
  HIC                hic,
  DWORD              dwFlags,
  LPBITMAPINFOHEADER lpbiSrc,
  LPVOID             lpSrc,
  int                xSrc,
  int                ySrc,
  int                dxSrc,
  int                dySrc,
  LPBITMAPINFOHEADER lpbiDst,
  LPVOID             lpDst,
  int                xDst,
  int                yDst,
  int                dxDst,
  int                dyDst
);

Parametri

hic

Handle per il decompressore.

dwFlags

Flag di decompressione. Vengono definiti i valori seguenti.

Valore Significato
ICDECOMPRESS_HURRYUP Tenta di decomprimere a una velocità più veloce. Quando un'applicazione usa questo flag, il driver deve memorizzare nel buffer i dati decompressi ma non disegnare l'immagine.
ICDECOMPRESS_NOTKEYFRAME Il frame corrente non è un fotogramma chiave.
ICDECOMPRESS_NULLFRAME Il frame corrente non contiene dati e l'immagine decompressa deve essere lasciata invariata.
ICDECOMPRESS_PREROLL Il fotogramma corrente precede il punto del filmato in cui viene avviata la riproduzione e, pertanto, non verrà disegnato.
ICDECOMPRESS_UPDATE La schermata viene aggiornata o aggiornata.

lpbiSrc

Puntatore a una struttura BITMAPINFOHEADER contenente il formato dei dati compressi.

lpSrc

Puntatore ai dati di input.

xSrc

Coordinata x del rettangolo di origine per il DIB specificato da lpbiSrc.

ySrc

Coordinata y del rettangolo di origine per il DIB specificato da lpbiSrc.

dxSrc

Larghezza del rettangolo di origine.

dySrc

Altezza del rettangolo di origine.

lpbiDst

Puntatore a una struttura BITMAPINFOHEADER contenente il formato di output.

lpDst

Puntatore a un buffer di dimensioni sufficienti per contenere i dati decompressi.

xDst

Coordinata x del rettangolo di destinazione per il DIB specificato da lpbiDst.

yDst

Coordinata y del rettangolo di destinazione per il DIB specificato da lpbiDst.

dxDst

Larghezza del rettangolo di destinazione.

dyDst

Altezza del rettangolo di destinazione.

Valore restituito

Restituisce ICERR_OK in caso di esito positivo o di errore.

Commenti

In genere, le applicazioni usano il flag ICDECOMPRESS_PREROLL per cercare un fotogramma chiave in un flusso compresso. Il flag viene inviato con il fotogramma chiave e con i fotogrammi successivi necessari per decomprimere il frame desiderato.

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

Vedi anche

Funzioni di compressione video

Gestione compressione video