ID2D1DeviceContext ::CreateBitmapFromDxgiSurface(IDXGISurface*,constD2D1_BITMAP_PROPERTIES1&,ID2D1Bitmap1**) méthode (d2d1_1.h)

Article
01/10/2024

Crée une bitmap à partir d’une surface DXGI qui peut être définie comme surface cible ou dont des informations supplémentaires sur le contexte de couleur sont spécifiées.

Syntaxe

HRESULT CreateBitmapFromDxgiSurface(
  [in]           IDXGISurface                    *surface,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 & bitmapProperties,
  [out]          ID2D1Bitmap1                    **bitmap
);

Paramètres

[in] surface

Type : IDXGISurface*

Surface DXGI à partir de laquelle la bitmap peut être créée.

Note La surface DXGI doit avoir été créée à partir du même appareil Direct3D auquel le contexte d’appareil Direct2D est associé.

[in, optional] bitmapProperties

Type : const D2D1_BITMAP_PROPERTIES1*

Propriétés bitmap spécifiées en plus de la surface.

[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.

Remarques

Si les propriétés bitmap ne sont pas spécifiées, les informations suivantes sont supposées :

La ppp bitmap est 96.
Le format de pixel correspond à celui de la surface.
La bitmap retournée héritera des indicateurs de liaison de la surface DXGI.
- Toutefois, seul le sous-ensemble d’indicateurs significatifs pour Direct2D sera hérité. Par exemple, D3D10_USAGE_DYNAMIC n’est pas compatible avec les indicateurs Direct2D publics.
Le contexte de couleur est inconnu.
Le mode alpha de la bitmap sera prémultiplié (cas courant) ou droit (A8).

Si les propriétés bitmap sont spécifiées, les propriétés bitmap sont utilisées comme suit :

L’ppp bitmap est spécifié par les propriétés bitmap.
Si dpiX et dpiY ont la valeur 0, la ppp bitmap est 96.
Le format de pixel doit être compatible avec l’affichage des ressources du nuanceur ou la vue cible de rendu de la surface.
Les options bitmap doivent être compatibles avec les indicateurs de liaison de la surface DXGI. Toutefois, il peut s’agir d’un sous-ensemble. Cela influence les vues de ressources créées par la bitmap.
Les informations de contexte de couleur sont utilisées à partir des propriétés bitmap, si elles sont spécifiées.

Configuration requise

Condition requise	Valeur
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 mise à jour de plateforme 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

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext ::SetTarget

Partager via