GetDIBits, fonction (wingdi.h)

La fonction GetDIBits récupère les bits de l’image bitmap compatible spécifiée et les copie dans une mémoire tampon en tant que DIB au format spécifié.

Syntaxe

int GetDIBits(
  [in]      HDC          hdc,
  [in]      HBITMAP      hbm,
  [in]      UINT         start,
  [in]      UINT         cLines,
  [out]     LPVOID       lpvBits,
  [in, out] LPBITMAPINFO lpbmi,
  [in]      UINT         usage
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] hbm

Handle de la bitmap. Il doit s’agir d’une bitmap compatible (DDB).

[in] start

Première ligne d’analyse à récupérer.

[in] cLines

Nombre de lignes d’analyse à récupérer.

[out] lpvBits

Pointeur vers une mémoire tampon pour recevoir les données bitmap. Si ce paramètre a la valeur NULL, la fonction transmet les dimensions et le format de l’image bitmap à la structure BITMAPINFO pointée par le paramètre lpbmi .

[in, out] lpbmi

Pointeur vers une structure BITMAPINFO qui spécifie le format souhaité pour les données DIB.

[in] usage

Format du membre bmiColors de la structure BITMAPINFO . Il doit s’agir de l’une des valeurs suivantes.

Valeur retournée

Si le paramètre lpvBits n’a pas la valeur NULL et que la fonction réussit, la valeur de retour correspond au nombre de lignes d’analyse copiées à partir de la bitmap.

Si le paramètre lpvBits a la valeur NULL et que GetDIBits remplit correctement la structure BITMAPINFO , la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Cette fonction peut retourner la valeur suivante.

Remarques

Si le format demandé pour la DIB correspond à son format interne, les valeurs RVB de la bitmap sont copiées. Si le format demandé ne correspond pas au format interne, une table de couleurs est synthétisée. Le tableau suivant décrit la table de couleurs synthétisée pour chaque format.

Si le paramètre lpvBits est un pointeur valide, les six premiers membres de la structure BITMAPINFOHEADER doivent être initialisés pour spécifier la taille et le format de la DIB. Les lignes d’analyse doivent être alignées sur un DWORD , à l’exception des bitmaps compressées RLE.

Une DIB ascendante est spécifiée en définissant la hauteur sur un nombre positif, tandis qu’une DIB descendante est spécifiée en définissant la hauteur sur un nombre négatif. La table de couleurs bitmap sera ajoutée à la structure BITMAPINFO .

Si lpvBits a la valeur NULL, GetDIBits examine le premier membre de la première structure pointée vers lpbi. Ce membre doit spécifier la taille, en octets, d’une structure BITMAPCOREHEADER ou BITMAPINFOHEADER . La fonction utilise la taille spécifiée pour déterminer comment les membres restants doivent être initialisés.

Si lpvBits a la valeur NULL et que le nombre de bits membre de BITMAPINFO est initialisé à zéro, GetDIBits remplit une structure BITMAPINFOHEADER ou BITMAPCOREHEADER sans la table de couleurs. Cette technique peut être utilisée pour interroger des attributs bitmap.

La bitmap identifiée par le paramètre hbmp ne doit pas être sélectionnée dans un contexte d’appareil lorsque l’application appelle cette fonction.

L’origine d’une DIB de bas en haut est le coin inférieur gauche de la bitmap ; l’origine d’une DIB en haut vers le bas est le coin supérieur gauche.

Exemples

Pour obtenir un exemple, consultez Capture d’une image.

Configuration requise

Voir aussi

BITMAPCOREHEADER

BITMAPINFO

BITMAPINFOHEADER

Fonctions bitmap

Vue d’ensemble des bitmaps

SetDIBits