énumération D2D1_BITMAP_OPTIONS (d2d1_1.h)

Article
08/22/2023

Spécifie comment une bitmap peut être utilisée.

Syntax

typedef enum D2D1_BITMAP_OPTIONS {
  D2D1_BITMAP_OPTIONS_NONE = 0x00000000,
  D2D1_BITMAP_OPTIONS_TARGET = 0x00000001,
  D2D1_BITMAP_OPTIONS_CANNOT_DRAW = 0x00000002,
  D2D1_BITMAP_OPTIONS_CPU_READ = 0x00000004,
  D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE = 0x00000008,
  D2D1_BITMAP_OPTIONS_FORCE_DWORD = 0xffffffff
} ;

Constantes


`D2D1_BITMAP_OPTIONS_NONE` Valeur : 0x00000000 La bitmap est créée avec les propriétés par défaut.
`D2D1_BITMAP_OPTIONS_TARGET` Valeur : 0x00000001 La bitmap peut être utilisée comme cible de contexte d’appareil.
`D2D1_BITMAP_OPTIONS_CANNOT_DRAW` Valeur : 0x00000002 La bitmap ne peut pas être utilisée comme entrée.
`D2D1_BITMAP_OPTIONS_CPU_READ` Valeur : 0x00000004 La bitmap peut être lue à partir du processeur.
`D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE` Valeur : 0x00000008 La bitmap fonctionne avec ID2D1GdiInteropRenderTarget::GetDC. Note Cet indicateur n’est pas disponible dans les applications du Windows Store.
`D2D1_BITMAP_OPTIONS_FORCE_DWORD` Valeur : 0xffffffff

Remarques

D2D1_BITMAP_OPTIONS_NONE implique qu’aucun indicateur n’est défini. Cela signifie que la bitmap peut être utilisée pour dessiner à partir de, ne peut pas être définie comme cible et ne peut pas être lue par le processeur.

D2D1_BITMAP_OPTIONS_TARGET signifie que la bitmap peut être spécifiée en tant que cible dans ID2D1DeviceContext::SetTarget. Si vous spécifiez également l’indicateur D2D1_BITMAP_OPTIONS_CANNOT_DRAW la bitmap peut être utilisée comme cible, mais elle ne peut pas être extraite. Si vous tentez de dessiner avec une bitmap dont les deux indicateurs sont définis, le contexte de l’appareil est placé dans un état d’erreur avec D2DERR_BITMAP_CANNOT_DRAW.

D2D1_BITMAP_OPTIONS_CPU_READ signifie que la bitmap peut être mappée à l’aide de ID2D1Bitmap1::Map. Cet indicateur nécessite D2D1_BITMAP_OPTIONS_CANNOT_DRAW et ne peut pas être combiné avec d’autres indicateurs. La bitmap doit être mise à jour avec les méthodes CopyFromBitmap ou CopyFromRenderTarget .

Note Vous devez utiliser D2D1_BITMAP_OPTIONS_CANNOT_DRAW est uniquement lorsque l’objectif de la bitmap est d’être une cible uniquement ou lorsque la bitmap sera mappée .

D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE signifie qu’il est possible d’obtenir un contrôleur de domaine associé à cette bitmap. Il doit être utilisé conjointement avec D2D1_BITMAP_OPTIONS_TARGET. Le DXGI_FORMAT doit être DXGI_FORMAT_B8G8R8A8_UNORM ou DXGI_FORMAT_B8G8R8A8_UNORM_SRGB.

Configuration requise


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]
En-tête	d2d1_1.h

Voir aussi

ID2D1DeviceContext::CreateBitmap

Partager via