Funzione ICLocate (vfw.h)

La funzione ICLocate trova un compressore o un decompressore in grado di gestire le immagini con i formati specificati oppure trova un driver in grado di decomprimere un'immagine con un formato specificato direttamente nell'hardware.

Sintassi

HIC VFWAPI ICLocate(
  DWORD              fccType,
  DWORD              fccHandler,
  LPBITMAPINFOHEADER lpbiIn,
  LPBITMAPINFOHEADER lpbiOut,
  WORD               wFlags
);

Parametri

fccType

Codice a quattro caratteri che indica il tipo di compressore o decompressore da aprire. Per i flussi video, il valore di questo parametro è "VIDC".

fccHandler

Gestore preferito del tipo specificato. In genere, il tipo di gestore viene archiviato nell'intestazione del flusso in un file AVI. Specificare NULL se l'applicazione può usare qualsiasi tipo di gestore o non conosce il tipo di gestore da usare.

lpbiIn

Puntatore a una struttura BITMAPINFOHEADER che definisce il formato di input. Un handle di compressore non viene restituito a meno che non supporti questo formato.

lpbiOut

Puntatore a una struttura BITMAPINFOHEADER che definisce un formato decompresso facoltativo. È anche possibile specificare zero per usare il formato di output predefinito associato al formato di input.

Se questo parametro è diverso da zero, un handle di compressore non viene restituito a meno che non possa creare questo formato di output.

wFlags

Flag che descrivono i criteri di ricerca per un compressore o un decompressore. Vengono definiti i valori seguenti:

Valore	Significato
ICMODE_COMPRESS	Trova un compressore in grado di comprimere un'immagine con un formato definito da lpbiIn nel formato definito da lpbiOut.
ICMODE_DECOMPRESS	Trova un decompressore che può decomprimere un'immagine con un formato definito da lpbiIn nel formato definito da lpbiOut.
ICMODE_DRAW	Trova un decompressore che può decomprimere un'immagine con un formato definito da lpbiIn e disegnare direttamente nell'hardware.
ICMODE_FASTCOMPRESS	Ha lo stesso significato di ICMODE_COMPRESS ad eccezione del compressore viene usato per un'operazione in tempo reale e sottolinea la velocità rispetto alla qualità.
ICMODE_FASTDECOMPRESS	Ha lo stesso significato di ICMODE_DECOMPRESS ad eccezione del decompressore viene usato per un'operazione in tempo reale e enfatizza la velocità rispetto alla qualità.

Valore restituito

Restituisce un handle a un compressore o a un decompressore in caso di esito positivo o zero in caso contrario.

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