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

Artikel
02/28/2024

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

Freigeben über