Partager via

ID2D1DeviceContext::CreateBitmap(D2D1_SIZE_U,constvoid*,UINT32,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) méthode (d2d1_1.h)

  • Article

Crée une bitmap qui peut être utilisée comme surface cible, pour la lecture dans le processeur ou comme source pour les API DrawBitmap et ID2D1BitmapBrush . En outre, les informations de contexte de couleur peuvent être passées à la bitmap.

Syntaxe

HRESULT CreateBitmap(
                 D2D1_SIZE_U                   size,
  [in, optional] const void                    *sourceData,
                 UINT32                        pitch,
  [in, ref]      const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

Paramètres

size

Type : D2D1_SIZE_U

Taille de pixels de la bitmap à créer.

[in, optional] sourceData

Type : const void*

Données initiales qui seront chargées dans la bitmap.

pitch

Type : UINT32

Pitch des données sources, s’il est spécifié.

[in, ref] bitmapProperties

Type : const D2D1_BITMAP_PROPERTIES1

Propriétés de la bitmap à créer.

[out] bitmap

Type : ID2D1Bitmap1**

Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers un nouvel objet bitmap.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

HRESULT Description
S_OK Aucune erreur ne s'est produite.
E_OUTOFMEMORY Direct2D n’a pas pu allouer suffisamment de mémoire pour terminer l’appel.
E_INVALIDARG Une valeur non valide a été passée à la méthode .
D3DERR_OUTOFVIDEOMEMORY Direct3D n’a pas suffisamment de mémoire d’affichage pour effectuer l’opération.

Notes

La nouvelle bitmap peut être utilisée comme cible pour SetTarget si elle est créée avec D2D1_BITMAP_OPTIONS_TARGET.

Spécifications

   
Client minimal pris en charge Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 et Platform Update pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d2d1_1.h
DLL D2d1.dll

Voir aussi

D2D1_BITMAP_PROPERTIES1

D2D1_SIZE_U

ID2D1Bitmap1

ID2D1DeviceContext