Metodo ID2D1DeviceContext::CreateBitmapFromDxgiSurface(IDXGISurface*,constD2D1_BITMAP_PROPERTIES1&,ID2D1Bitmap1**) (d2d1_1.h)

Articolo
08/22/2023

Crea una bitmap da una superficie DXGI che può essere impostata come superficie di destinazione o avere informazioni aggiuntive sul contesto del colore specificate.

Sintassi

HRESULT CreateBitmapFromDxgiSurface(
  [in]           IDXGISurface                    *surface,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 & bitmapProperties,
  [out]          ID2D1Bitmap1                    **bitmap
);

Parametri

[in] surface

Tipo: IDXGISurface*

Superficie DXGI da cui è possibile creare la bitmap.

Nota La superficie DXGI deve essere stata creata dallo stesso dispositivo Direct3D a cui è associato il contesto del dispositivo Direct2D.

[in, optional] bitmapProperties

Tipo: const D2D1_BITMAP_PROPERTIES1*

Le proprietà bitmap specificate oltre alla superficie.

[out] bitmap

Tipo: ID2D1Bitmap1**

Quando questo metodo restituisce, contiene l'indirizzo di un puntatore a un nuovo oggetto bitmap.

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 valore non valido è stato passato al metodo.
D3DERR_OUTOFVIDEOMEMORY	Direct3D non dispone di memoria di visualizzazione sufficiente per eseguire l'operazione.

Commenti

Se le proprietà bitmap non vengono specificate, vengono presupposte le informazioni seguenti:

La bitmap DPI è 96.
Il formato pixel corrisponde a quello della superficie.
La bitmap restituita erediterà i flag di associazione della superficie DXGI.
- Tuttavia, solo il subset di flag significativi per Direct2D verrà ereditato. Ad esempio, D3D10_USAGE_DYNAMIC non è compatibile con i flag Direct2D pubblici.
Il contesto del colore è sconosciuto.
La modalità alfa della bitmap sarà premultiplied (caso comune) o dritta (A8).

Se vengono specificate le proprietà bitmap, le proprietà bitmap verranno usate come segue:

Il valore DPI bitmap verrà specificato dalle proprietà bitmap.
Se dpiX e dpiY sono 0, il valore DPI bitmap sarà 96.
Il formato pixel deve essere compatibile con la visualizzazione delle risorse shader o la visualizzazione di destinazione del rendering della superficie.
Le opzioni bitmap devono essere compatibili con i flag di associazione della superficie DXGI. Tuttavia, possono essere un subset. Ciò influisce sulle visualizzazioni delle risorse create dalla bitmap.
Le informazioni sul contesto del colore verranno usate dalle proprietà bitmap, se specificato.

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

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::SetTarget

Share via