IcCompressorChoose, fonction (vfw.h)

La fonction ICCompressorChoose affiche une boîte de dialogue dans laquelle un utilisateur peut sélectionner un compresseur. Cette fonction peut afficher tous les compresseurs inscrits ou répertorier uniquement les compresseurs qui prennent en charge un format spécifique.

Syntaxe

BOOL VFWAPI ICCompressorChoose(
  HWND      hwnd,
  UINT      uiFlags,
  LPVOID    pvIn,
  LPVOID    lpData,
  PCOMPVARS pc,
  LPSTR     lpszTitle
);

Paramètres

hwnd

Gérer vers une fenêtre parente pour la boîte de dialogue.

uiFlags

Indicateurs applicables. Les valeurs suivantes sont définies.

Valeur	Signification
ICMF_CHOOSE_ALLCOMPRESSORS	Tous les compresseurs doivent apparaître dans la liste de sélection. Si cet indicateur n’est pas spécifié, seuls les compresseurs qui peuvent gérer le format d’entrée apparaissent dans la liste de sélection.
ICMF_CHOOSE_DATARATE	Affiche une zone case activée et une zone d’édition pour entrer le débit de données de la vidéo.
ICMF_CHOOSE_KEYFRAME	Affiche une zone case activée et une zone d’édition pour entrer la fréquence des images clés.
ICMF_CHOOSE_PREVIEW	Affiche un bouton pour développer la boîte de dialogue afin d’inclure une fenêtre d’aperçu. La fenêtre d’aperçu montre comment les images de votre film apparaîtront lorsqu’elles seront compressées avec les paramètres actuels.

pvIn

Format d’entrée de données non compressé. Seuls les compresseurs qui prennent en charge le format d’entrée de données spécifié sont inclus dans la liste des compresseurs. Ce paramètre est facultatif.

lpData

Pointeur vers une interface de flux AVI à utiliser dans la fenêtre d’aperçu. Vous devez spécifier un flux vidéo. Ce paramètre est facultatif.

pc

Pointeur vers une structure COMPVARS . Les informations retournées initialisent la structure pour une utilisation avec d’autres fonctions.

lpszTitle

Pointeur vers une chaîne terminée par null contenant un titre pour la boîte de dialogue. Ce paramètre est facultatif.

Valeur renvoyée

Retourne TRUE si l’utilisateur choisit un compresseur et appuie sur OK. Retourne FALSE en cas d’erreur ou si l’utilisateur appuie sur CANCEL.

Remarques

Avant d’utiliser cette fonction, définissez le membre cbSize de la structure COMPVARS sur la taille de la structure. Initialisez le reste de la structure sur zéros, sauf si vous souhaitez spécifier des valeurs par défaut valides pour la boîte de dialogue. Si vous spécifiez des valeurs par défaut, définissez le membre dwFlags sur ICMF_COMPVARS_VALID et initialisez les autres membres de la structure. Pour plus d’informations sur l’initialisation de la structure, consultez la fonction ICSeqCompressFrameStart et COMPVARS.

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