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

  • Artikel

Erstellt eine Bitmap aus einer DXGI-Oberfläche, die als Zieloberfläche festgelegt werden kann oder zusätzliche Farbkontextinformationen angegeben sind.

Syntax

HRESULT CreateBitmapFromDxgiSurface(
  [in]           IDXGISurface                    *surface,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 & bitmapProperties,
  [out]          ID2D1Bitmap1                    **bitmap
);

Parameter

[in] surface

Typ: IDXGISurface*

Die DXGI-Oberfläche, auf der die Bitmap erstellt werden kann.

Hinweis Die DXGI-Oberfläche muss auf demselben Direct3D-Gerät erstellt worden sein, dem der Direct2D-Gerätekontext zugeordnet ist.
 

[in, optional] bitmapProperties

Typ: const D2D1_BITMAP_PROPERTIES1*

Die zusätzlich zur Oberfläche angegebenen Bitmapeigenschaften.

[out] bitmap

Typ: ID2D1Bitmap1**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf ein neues Bitmapobjekt.

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.
E_OUTOFMEMORY Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Aufruf abzuschließen.
E_INVALIDARG Ein ungültiger Wert wurde an die -Methode übergeben.
D3DERR_OUTOFVIDEOMEMORY Direct3D verfügt nicht über genügend Anzeigespeicher, um den Vorgang auszuführen.

Hinweise

Wenn die Bitmapeigenschaften nicht angegeben werden, werden die folgenden Informationen angenommen:

  • Die Bitmap-DPI ist 96.
  • Das Pixelformat entspricht dem der Oberfläche.
  • Die zurückgegebene Bitmap erbt die Bindungsflags der DXGI-Oberfläche.
    • Allerdings wird nur die Teilmenge der Für Direct2D aussagekräftigen Flags geerbt. Beispielsweise ist D3D10_USAGE_DYNAMIC nicht mit öffentlichen Direct2D-Flags kompatibel.
  • Der Farbkontext ist unbekannt.
  • Der Alphamodus der Bitmap ist vormultipliziert (allgemeine Groß-/Kleinschreibung) oder gerade (A8).
Wenn die Bitmapeigenschaften angegeben werden, werden die Bitmapeigenschaften wie folgt verwendet:
  • Die Bitmap-DPI wird durch die Bitmapeigenschaften angegeben.
  • Wenn sowohl dpiX als auch dpiY 0 sind, ist die Bitmap-DPI 96.
  • Das Pixelformat muss mit der Shaderressourcenansicht oder der Renderzielansicht der Oberfläche kompatibel sein.
  • Die Bitmapoptionen müssen mit den Bindungsflags der DXGI-Oberfläche kompatibel sein. Sie können jedoch eine Teilmenge sein. Dies beeinflusst, welche Ressourcenansichten von der Bitmap erstellt werden.
  • Die Farbkontextinformationen werden aus den Bitmapeigenschaften verwendet, sofern angegeben.

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

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::SetTarget