Méthode IGetFrame::SetFormat (vfw.h)

Article
08/27/2023

La méthode SetFormat définit le format d’image décompressé des images en cours d’extraction et fournit éventuellement une mémoire tampon pour l’opération de décompression.

Syntaxe

HRESULT SetFormat(
  LPBITMAPINFOHEADER lpbi,
  LPVOID             lpBits,
  int                x,
  int                y,
  int                dx,
  int                dy
);

Paramètres

lpbi

Pointeur vers une structure BITMAPINFOHEADER définissant le format d’image décompressé. Vous pouvez également spécifier NULL ou la valeur ((LPBITMAPINFOHEADER) 1) pour ce paramètre. Null oblige le décompresseur à choisir un format approprié pour la modification (normalement un format de profondeur d’image 24 bits). La valeur ((LPBITMAPINFOHEADER) 1) oblige le décompresseur à choisir un format approprié pour le mode d’affichage actuel.

lpBits

Pointeur vers une mémoire tampon pour contenir les données d’image décompressées. Spécifiez NULL pour que cette méthode alloue une mémoire tampon.

x

Coordonnée x du rectangle de destination dans la DIB spécifiée par lpbi. Ce paramètre est utilisé lorsque lpBits n’a pas la valeur NULL.

y

Coordonnée y du rectangle de destination dans la DIB spécifiée par lpbi. Ce paramètre est utilisé lorsque lpBits n’a pas la valeur NULL.

dx

Largeur du rectangle de destination. Ce paramètre est utilisé lorsque lpBits n’a pas la valeur NULL.

dy

Hauteur du rectangle de destination. Ce paramètre est utilisé lorsque lpBits n’a pas la valeur NULL.

Valeur retournée

Retourne NOERROR en cas de réussite, E_OUTOFMEMORY si l’image décompressée est supérieure à la taille de la mémoire tampon, ou E_FAIL sinon.

Remarques

Les paramètres x, y, dx et dy identifient la partie de l’image bitmap spécifiée par lpbi et lpBits qui reçoit l’image décompressée.

Pour les gestionnaires écrits en C++, SetFormat a la syntaxe suivante :


HRESULT SetFormat(LPBITMAPINFOHEADER lpbi, LPVOID lpBits, int x, 
    int y, int dx, int dy);

Configuration requise


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

Voir aussi

Interfaces de gestionnaire de fichiers et de flux personnalisés

Gestionnaires de fichiers et de flux personnalisés

Partager via