ID2D1DeviceContext ::CreateBitmapFromDxgiSurface(IDXGISurface*,constD2D1_BITMAP_PROPERTIES1&,ID2D1Bitmap1**) méthode (d2d1_1.h)
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.
[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).
- 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour