ID2D1Bitmap ::CopyFromMemory, méthode (d2d1.h)

  • Article

Copie la région spécifiée à partir de la mémoire dans la bitmap actuelle.

Syntaxe

HRESULT CopyFromMemory(
  [in, optional] const D2D1_RECT_U *dstRect,
  [in]           const void        *srcData,
                 UINT32            pitch
);

Paramètres

[in, optional] dstRect

Type : const D2D1_RECT_U*

Dans la bitmap actuelle, le rectangle dans lequel la région spécifiée par srcRect est copiée.

[in] srcData

Type : const void*

Données à copier.

pitch

Type : UINT32

La foulée, ou pitch, de l’image bitmap source stockée dans srcData. La foulée est le nombre d’octets d’une ligne de balayage (une ligne de pixels en mémoire). La foulée peut être calculée à partir de la formule suivante : largeur des pixels * octets par pixel + remplissage de mémoire.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .

Remarques

Cette méthode ne met pas à jour la taille de l’image bitmap actuelle. Si le contenu de l’image bitmap source ne tient pas dans la bitmap actuelle, cette méthode échoue. Notez également que cette méthode n’effectue pas de conversion de format ; les deux formats bitmap doivent correspondre.

Si cette méthode est transmise à une entrée non valide (par exemple, un rectangle de destination non valide), peut produire des résultats imprévisibles, tels qu’une image déformée ou une défaillance d’appareil.

L’appel de cette méthode peut entraîner la vidage du lot actuel si la bitmap est active dans le lot. Si le lot qui a été vidé ne se termine pas correctement, cette méthode échoue. Toutefois, cette méthode n’efface pas l’état d’erreur de la cible de rendu sur laquelle le lot a été vidé. L’état HRESULT et tag défaillants seront retournés lors de l’appel suivant à EndDraw ou Flush.

À compter de Windows 8.1, cette méthode prend en charge les bitmaps compressées par blocs. Si vous utilisez un format compressé par bloc, les coordonnées de fin du paramètre srcRect doivent être des multiples de 4 ou la méthode retourne E_INVALIDARG.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d2d1.h
Bibliothèque D2d1.lib
DLL D2d1.dll

Voir aussi

ID2D1Bitmap