Structure COMPVARS (vfw.h)
La structure COMPVARS décrit les paramètres du compresseur pour des fonctions telles que ICCompressorChoose, ICSeqCompressFrame et ICCompressorFree.
Syntaxe
typedef struct {
LONG cbSize;
DWORD dwFlags;
HIC hic;
DWORD fccType;
DWORD fccHandler;
LPBITMAPINFO lpbiIn;
LPBITMAPINFO lpbiOut;
LPVOID lpBitsOut;
LPVOID lpBitsPrev;
LONG lFrame;
LONG lKey;
LONG lDataRate;
LONG lQ;
LONG lKeyCount;
LPVOID lpState;
LONG cbState;
} COMPVARS, *PCOMPVARS;
Membres
cbSize
Taille, en octets, de cette structure. Ce membre doit être défini pour valider la structure avant d’appeler une fonction à l’aide de cette structure.
dwFlags
Indicateurs applicables. La valeur suivante est définie :
| Nom | Description |
|---|---|
|
Les données de cette structure sont valides et ont été entrées manuellement. Définissez cet indicateur avant d’appeler une fonction si vous remplissez cette structure manuellement. Ne définissez pas cet indicateur si vous laissez ICCompressorChoose initialiser cette structure. |
hic
Poignée au compresseur à utiliser. Vous pouvez ouvrir un compresseur et obtenir une poignée de celui-ci à l’aide de la fonction ICOpen . Vous pouvez également choisir un compresseur à l’aide d’ICCompressorChoose. ICCompressorChoose ouvre le compresseur choisi et retourne la poignée du compresseur dans ce membre. Vous pouvez fermer le compresseur à l’aide d’ICCompressorFree.
fccType
Type de compresseur utilisé. Actuellement, seul ICTYPE_VIDEO (VIDC) est pris en charge. Ce membre peut être défini sur zéro.
fccHandler
Code à quatre caractères du compresseur. Spécifiez NULL pour indiquer que les données ne doivent pas être re compressées. Spécifiez « DIB » pour indiquer que les données sont une image complète non compressée. Vous pouvez utiliser ce membre pour spécifier le compresseur sélectionné par défaut lorsque la boîte de dialogue s’affiche.
lpbiIn
Réservé ; ne pas utiliser.
lpbiOut
Pointeur vers une structure BITMAPINFO contenant le format de sortie d’image. Vous pouvez spécifier un format spécifique à utiliser ou vous pouvez spécifier NULL pour utiliser le compresseur par défaut associé au format d’entrée. Vous pouvez également définir le format de sortie de l’image à l’aide d’ICCompressorChoose.
lpBitsOut
Réservé ; ne pas utiliser.
lpBitsPrev
Réservé ; ne pas utiliser.
lFrame
Réservé ; ne pas utiliser.
lKey
Fréquence d’images clés. Spécifiez un entier pour indiquer la fréquence à laquelle les images clés doivent se produire dans la séquence compressée ou zéro pour ne pas utiliser d’images clés. Vous pouvez également laisser ICCompressorChoose définir la fréquence d’images de clé sélectionnée dans la boîte de dialogue. La fonction ICSeqCompressFrameStart utilise la valeur de ce membre pour créer des images clés.
lDataRate
Débit de données, en kilo-octets par seconde. ICCompressorChoose copie le débit de données sélectionné de la boîte de dialogue vers ce membre.
lQ
Paramètre de qualité. Spécifiez un paramètre de qualité de 1 à 10 000 ou spécifiez ICQUALITY_DEFAULT pour utiliser le paramètre de qualité par défaut. Vous pouvez également laisser ICCompressorChoose définir la valeur de qualité sélectionnée dans la boîte de dialogue. ICSeqCompressFrameStart utilise la valeur de ce membre comme paramètre de qualité.
lKeyCount
Réservé ; ne pas utiliser.
lpState
Réservé ; ne pas utiliser.
cbState
Réservé ; ne pas utiliser.
Remarques
Vous pouvez laisser ICCompressorChoose remplir le contenu de cette structure ou vous pouvez le faire manuellement. Si vous remplissez manuellement la structure, vous devez fournir des informations pour les membres suivants : cbSize, hic, lpbiOut, lKey et lQ. En outre, vous devez définir l’indicateur ICMF_COMPVARS_VALID dans le membre dwFlags .
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] |
| En-tête | vfw.h |
Voir aussi
Gestionnaire de compression vidéo