DdCreateDIBSection, fonction (ddrawgdi.h)

[Cette fonction est susceptible d’être modifiée à chaque révision du système d’exploitation. Utilisez plutôt Microsoft DirectDraw et Microsoft Direct3DAPIs ; ces API isolent les applications de ces modifications du système d’exploitation et masquent de nombreuses autres difficultés liées à l’interaction directe avec les pilotes d’affichage.]

Crée une structure DIBSECTION qui partage sa table de couleurs avec l’appareil.

GdiEntry9 est défini comme alias pour cette fonction.

Syntaxe

HBITMAP DdCreateDIBSection(
  HDC              hdc,
  const BITMAPINFO *pbmi,
  UINT             iUsage,
  VOID             **ppvBits,
  HANDLE           hSectionApp,
  DWORD            dwOffset
);

Paramètres

hdc

Un contrôleur de domaine valide compatible avec le périphérique d’affichage actuel.

pbmi

Pointeur vers une structure BITMAPINFO qui décrit la DIBSECTION demandée.

iUsage

Spécifie le type de données contenues dans le membre du tableau bmiColors de la structure BITMAPINFO pointée par pbmi (index de palette logique ou valeurs RVB littérales). Les valeurs suivantes sont définies.

(DIB_PAL_COLORS)

Le membre bmiColors est un tableau d’index 16 bits dans la palette logique du contexte d’appareil spécifié par hdc.

(DIB_RGB_COLORS)

La structure BITMAPINFO contient un tableau de valeurs RVB littérales.

ppvBits

Pointeur vers un pointeur vers les données DIBSECTION créées.

hSectionApp

Réservé. Doit être NULL.

dwOffset

Valeur retournée

Si elle réussit, cette fonction retourne un handle à une bitmap représentant la DIBSECTION ; sinon, elle retourne LA VALEUR NULL.

Remarques

L’appel de cette fonction garantit une palette d’identités et aucune conversion de palette lorsque IDirectDrawSurface7 ::Blt ou StretchBlt sont appelés.

Il est recommandé aux applications d’utiliser IDirectDrawSurface7, qui peut créer des surfaces de 8 bits par pixel, avec palette d’identité, indépendamment du système d’exploitation.

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	ddrawgdi.h

Voir aussi

Prise en charge du client de bas niveau graphique