ID2D1Bitmap1::GetSurface-Methode (d2d1_1.h)

Ruft entweder die Oberfläche ab, die beim Erstellen der Bitmap angegeben wurde, oder die Standardoberfläche, die beim Erstellen der Bitmap erstellt wurde.

Syntax

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

Parameter

[out, optional] dxgiSurface

Typ: IDXGISurface**

Die zugrunde liegende DXGI-Oberfläche für die Bitmap.

Rückgabewert

Typ: HRESULT

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

HRESULT	BESCHREIBUNG
S_OK	Kein Fehler ist aufgetreten.
D2DERR_BITMAP_BOUND_AS_TARGET	Es kann nicht mit einer Bitmap gezeichnet werden, die derzeit als Zielbit gebunden ist.

Hinweise

Die verwendete Bitmap muss aus einem DXGI-Oberflächenrenderingziel, einem abgeleiteten Renderziel oder einem Gerätekontext erstellt worden sein, der aus einem ID2D1Device erstellt wurde.

Die zurückgegebene Oberfläche kann mit Microsoft Direct3D oder jeder anderen API verwendet werden, die mit freigegebenen Oberflächen interagiert. Die Anwendung muss transitiv sicherstellen, dass die Oberfläche auf dem direct3D-Gerät verwendet werden kann, das in diesem Kontext verwendet wird. Wenn Sie beispielsweise die Oberfläche mit Direct2D verwenden, muss das Direct2D-Renderziel über ID2D1Factory::CreateDxgiSurfaceRenderTarget oder in einem Gerätekontext erstellt worden sein, der auf demselben Gerät erstellt wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1_1.h
DLL	D2d1.dll

Weitere Informationen

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap