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
ID2D1DeviceContext::CreateBitmap