Fonction ICLocate (vfw.h)

La fonction ICLocate recherche un compresseur ou un décompresseur qui peut gérer des images avec les formats spécifiés, ou un pilote qui peut décompresser une image avec un format spécifié directement sur le matériel.

Syntaxe

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

Paramètres

fccType

Code de quatre caractères indiquant le type de compresseur ou de décompresseur à ouvrir. Pour les flux vidéo, la valeur de ce paramètre est « VIDC ».

fccHandler

Gestionnaire préféré du type spécifié. En règle générale, le type de gestionnaire est stocké dans l’en-tête de flux dans un fichier AVI. Spécifiez NULL si votre application peut utiliser n’importe quel type de gestionnaire ou si elle ne connaît pas le type de gestionnaire à utiliser.

lpbiIn

Pointeur vers une structure BITMAPINFOHEADER définissant le format d’entrée. Une poignée de compresseur n’est retournée que si elle prend en charge ce format.

lpbiOut

Pointeur vers une structure BITMAPINFOHEADER définissant un format décompressé facultatif. Vous pouvez également spécifier zéro pour utiliser le format de sortie par défaut associé au format d’entrée.

Si ce paramètre n’est pas nul, un handle de compresseur n’est pas retourné, sauf s’il peut créer ce format de sortie.

wFlags

Indicateurs qui décrivent les critères de recherche d’un compresseur ou d’un décompresseur. Les valeurs suivantes sont définies :

Valeur	Signification
ICMODE_COMPRESS	Recherche un compresseur qui peut compresser une image au format défini par lpbiIn au format défini par lpbiOut.
ICMODE_DECOMPRESS	Recherche un décompresseur qui peut décompresser une image au format défini par lpbiIn au format défini par lpbiOut.
ICMODE_DRAW	Recherche un décompresseur qui peut décompresser une image au format défini par lpbiIn et la dessiner directement sur le matériel.
ICMODE_FASTCOMPRESS	A la même signification que ICMODE_COMPRESS sauf que le compresseur est utilisé pour un fonctionnement en temps réel et met l’accent sur la vitesse sur la qualité.
ICMODE_FASTDECOMPRESS	A la même signification que ICMODE_DECOMPRESS sauf que le décompresseur est utilisé pour une opération en temps réel et met l’accent sur la vitesse sur la qualité.

Valeur retournée

Retourne une poignée à un compresseur ou un décompresseur en cas de réussite ou de zéro dans le cas contraire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vfw.h
Bibliothèque	Vfw32.lib
DLL	Msvfw32.dll

Voir aussi

Fonctions de compression vidéo

Gestionnaire de compression vidéo