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

  • Articolo

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