METODO ID2D1DeviceContext::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) (d2d1_1.h)

Crea una bitmap Direct2D copiando una bitmap WIC.

Sintassi

HRESULT CreateBitmapFromWicBitmap(
  [in]           IWICBitmapSource              *wicBitmapSource,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

Parametri

[in] wicBitmapSource

Tipo: IWICBitmapSource*

Origine bitmap WIC da cui copiare.

[in, optional] bitmapProperties

Tipo: const D2D1_BITMAP_PROPERTIES1*

Struttura delle proprietà bitmap che specifica le opzioni di creazione bitmap.

[out] bitmap

Tipo: ID2D1Bitmap1**

Indirizzo dell'oggetto bitmap appena creato.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

HRESULT	Descrizione
S_OK	Non si sono verificati errori.
E_OUTOFMEMORY	Direct2D non è riuscito a allocare memoria sufficiente per completare la chiamata.
E_INVALIDARG	Un parametro non valido è stato passato alla funzione restituita.

Commenti

A partire da Windows 8.1, il parametro bitmapProperties è facoltativo. Quando non viene specificato, la bitmap creata eredita il formato pixel e la modalità alfa da wicBitmapSource. Per un elenco di formati pixel supportati e modalità alfa, vedere Formati pixel supportati e modalità alfa.

Quando viene specificato il parametro bitmapProperties, il valore in bitmapProperties-pixelFormat> deve essere DXGI_FORMAT_UNKNOWN o deve corrispondere al formato di pixel WIC in wicBitmapSource.

Quando bitmapProperties-pixelFormat.alphaMode> è impostato su D2D1_ALPHA_MODE_UNKNOWN, la bitmap appena creata eredita la modalità alfa da wicBitmapSource. Quando bitmapProperties-pixelFormat.alphaMode> è impostato su D2D1_ALPHA_MODE_PREMULTIPLIED, D2D1_ALPHA_MODE_STRAIGHT o D2D1_ALPHA_MODE_IGNORE, questo forza la bitmap appena creata per usare la modalità alfa specificata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e Aggiornamento della piattaforma per Windows 7 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1_1.h
DLL	D2d1.dll

Vedi anche

ID2D1DeviceContext