Metodo ID2D1Bitmap::CopyFromMemory (d2d1.h)

Copia l'area specificata dalla memoria nella bitmap corrente.

Sintassi

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

Parametri

[in, optional] dstRect

Tipo: const D2D1_RECT_U*

Nella bitmap corrente il rettangolo in cui viene copiata l'area specificata da srcRect .

[in] srcData

Tipo: const void*

I dati da copiare.

pitch

Tipo: UINT32

Stride, o pitch, della bitmap di origine archiviata in srcData. Lo stride è il conteggio dei byte di una linea di analisi (una riga di pixel in memoria). Lo stride può essere calcolato dalla formula seguente: larghezza pixel * byte per pixel + spaziatura interna della memoria.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo non aggiorna le dimensioni della bitmap corrente. Se il contenuto della bitmap di origine non rientra nella bitmap corrente, questo metodo ha esito negativo. Si noti inoltre che questo metodo non esegue la conversione del formato; i due formati bitmap devono corrispondere.

Se questo metodo viene passato un input non valido ,ad esempio un rettangolo di destinazione non valido, può produrre risultati imprevedibili, ad esempio un'immagine distorta o un errore del dispositivo.

La chiamata a questo metodo può causare lo scaricamento del batch corrente se la bitmap è attiva nel batch. Se il batch scaricato non viene completato correttamente, questo metodo ha esito negativo. Tuttavia, questo metodo non cancella lo stato di errore della destinazione di rendering in cui è stato scaricato il batch. Lo stato HRESULT e tag non riuscito verranno restituiti alla chiamata successiva a EndDraw o Flush.

A partire da Windows 8.1, questo metodo supporta bitmap compresse in blocchi. Se si utilizza un formato compresso a blocchi, le coordinate finali del parametro srcRect devono essere multiple di 4 oppure il metodo restituisce E_INVALIDARG.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1.h
Libreria	D2d1.lib
DLL	D2d1.dll

Vedi anche

ID2D1Bitmap