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 |