Fonction ICDrawBegin (vfw.h)
La fonction ICDrawBegin initialise le convertisseur et prépare la destination du dessin pour le dessin.
Syntaxe
DWORD VFWAPIV ICDrawBegin(
HIC hic,
DWORD dwFlags,
HPALETTE hpal,
HWND hwnd,
HDC hdc,
int xDst,
int yDst,
int dxDst,
int dyDst,
LPBITMAPINFOHEADER lpbi,
int xSrc,
int ySrc,
int dxSrc,
int dySrc,
DWORD dwRate,
DWORD dwScale
);
Paramètres
hic
Gérez le décompresseur à utiliser.
dwFlags
Indicateurs de décompression. Les valeurs suivantes sont définies.
| Valeur | Signification |
|---|---|
| ICDRAW_ANIMATE | L’application peut animer la palette. |
| ICDRAW_CONTINUE | Le dessin est une continuation du cadre précédent. |
| ICDRAW_FULLSCREEN | Dessine les données décompressées en plein écran. |
| ICDRAW_HDC | Dessine les données décompressées dans une fenêtre ou un contrôleur de domaine. |
| ICDRAW_MEMORYDC | Le contrôleur de domaine est hors écran. |
| ICDRAW_QUERY | Détermine si le décompresseur peut décompresser les données. Le pilote ne décompresse pas les données. |
| ICDRAW_UPDATING | L’image actuelle est mise à jour plutôt que lue. |
hpal
Gérez la palette utilisée pour le dessin.
hwnd
Gérer la fenêtre utilisée pour le dessin.
hdc
Contrôleur de domaine utilisé pour le dessin.
xDst
Coordonnée x du coin supérieur droit du rectangle de destination.
yDst
Coordonnée y du coin supérieur droit du rectangle de destination.
dxDst
Largeur du rectangle de destination.
dyDst
Hauteur du rectangle de destination.
lpbi
Pointeur vers une structure BITMAPINFOHEADER contenant le format des données d’entrée à décompresser.
xSrc
Coordonnée x du coin supérieur droit du rectangle source.
ySrc
Coordonnée y du coin supérieur droit du rectangle source.
dxSrc
Largeur du rectangle source.
dySrc
Hauteur du rectangle source.
dwRate
Numérateur de fréquence d’images. La fréquence d’images, en images par seconde, est obtenue en divisant dwRate par dwScale.
dwScale
Dénominateur de fréquence d’images. La fréquence d’images, en images par seconde, est obtenue en divisant dwRate par dwScale.
Valeur retournée
Retourne ICERR_OK si le convertisseur peut décompresser les données ou ICERR_UNSUPPORTED sinon.
Remarques
Les indicateurs ICDRAW_HDC et ICDRAW_FULLSCREEN s’excluent mutuellement. Si une application définit l’indicateur ICDRAW_HDC dans dwFlags, le décompresseur utilise hwnd, hdc et les paramètres définissant le rectangle de destination (xDst, yDst, dxDst et dyDst). Votre application doit définir ces paramètres sur la taille du rectangle de destination. Spécifiez les valeurs du rectangle de destination par rapport à la fenêtre ou au contrôleur de domaine actuel.
Si une application définit l’indicateur ICDRAW_FULLSCREEN dans dwFlags, les paramètres hwnd et hdc ne sont pas utilisés et doivent être définis sur NULL. En outre, le rectangle de destination n’est pas utilisé et ses paramètres peuvent être définis sur zéro.
Le rectangle source est relatif à l’image vidéo complète. La partie de l’image vidéo spécifiée par le rectangle source est étirée ou réduite pour s’adapter au rectangle de destination.
Les paramètres dwRate et dwScale spécifient le taux de décompression. La valeur entière spécifiée pour dwRate divisée par la valeur entière spécifiée pour dwScale définit la fréquence d’images par seconde. Cette valeur est utilisée par le convertisseur lorsqu’il est responsable du minutage des images pendant la lecture.
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 |