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 con 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 di dispositivo Direct2D.
 

[in, optional] bitmapProperties

Tipo: const D2D1_BITMAP_PROPERTIES1*

Proprietà bitmap specificate oltre alla superficie.

[out] bitmap

Tipo: ID2D1Bitmap1**

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

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore 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 ad 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 considerate le informazioni seguenti:

  • Il valore DPI bitmap è 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 alcun flag Direct2D pubblico.
  • Il contesto del colore è sconosciuto.
  • La modalità alfa della bitmap sarà premoltiplicata (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à della bitmap.
  • Se dpiX e dpiY sono 0, il valore DPI bitmap sarà 96.
  • Il formato pixel deve essere compatibile con la visualizzazione risorse shader o la visualizzazione di destinazione di rendering della superficie.
  • Le opzioni bitmap devono essere compatibili con i flag di associazione della superficie DXGI. Tuttavia, possono essere un subset. Ciò influirà 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