ID2D1Bitmap ::CopyFromMemory, méthode (d2d1.h)
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 |