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 |