Metodo ID2D1Bitmap1::GetSurface (d2d1_1.h)

Ottiene la superficie specificata quando è stata creata la bitmap o la superficie predefinita creata al momento della creazione della bitmap.

Sintassi

HRESULT GetSurface(
  [out, optional] IDXGISurface **dxgiSurface
);

Parametri

[out, optional] dxgiSurface

Tipo: IDXGISurface**

Superficie DXGI sottostante per la 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.
D2DERR_BITMAP_BOUND_AS_TARGET Impossibile disegnare con una bitmap attualmente associata come bitmap di destinazione.

Commenti

La bitmap usata deve essere stata creata da una destinazione di rendering della superficie DXGI, da una destinazione di rendering derivata o da un contesto di dispositivo creato da un ID2D1Device.

La superficie restituita può essere usata con Microsoft Direct3D o qualsiasi altra API che interagisce con le superfici condivise. L'applicazione deve garantire in modo transitivo che la superficie sia utilizzabile nel dispositivo Direct3D usata in questo contesto. Ad esempio, se si usa la superficie con Direct2D, la destinazione di rendering Direct2D deve essere stata creata tramite ID2D1Factory::CreateDxgiSurfaceRenderTarget o in un contesto di dispositivo creato nello stesso dispositivo.

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

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap