RenderTargetProperties-Funktion (d2d1helper.h)

Artikel
08/22/2023

Erstellt eine D2D1_RENDER_TARGET_PROPERTIES-Struktur .

Syntax

D2D1_RENDER_TARGET_PROPERTIES RenderTargetProperties(
       D2D1_RENDER_TARGET_TYPE   type,
  [in] const D2D1_PIXEL_FORMAT & pixelFormat,
       FLOAT                     dpiX,
       FLOAT                     dpiY,
       D2D1_RENDER_TARGET_USAGE  usage,
       D2D1_FEATURE_LEVEL        minLevel
);

Parameter

type

Typ: D2D1_RENDER_TARGET_TYPE

Ein Wert, der angibt, ob das Renderziel Hardwarerendering oder Softwarerendering verwenden muss. Der Standardwert D2D1_RENDER_TARGET_TYPE_DEFAULT gibt an, dass Hardwarerendering verwendet wird. wenn kein Hardwarerendering verfügbar ist, verwendet das Renderziel Softwarerendering. Beachten Sie, dass WIC-Bitmaprenderziele kein Hardwarerendering unterstützen.

[in] pixelFormat

Typ: const D2D1_PIXEL_FORMAT

Das Pixelformat und der Alphamodus des Renderziels. Das Standardpixelformat ist D2D1::P ixelFormat, wodurch Direct2D angibt, ein Pixelformat auszuwählen, das vom Renderziel unterstützt wird. Eine Liste der Pixelformate und Alphamodi, die von jedem Renderziel unterstützt werden, finden Sie unter Unterstützte Pixelformate und Alphamodi.

dpiX

Typ: FLOAT

Der horizontale DPI des Renderziels. Der Standardwert ist 0,0. Wenn sowohl dpiX als auch dpiY auf 0,0 festgelegt sind, verwendet das Renderziel seinen Standard-DPI. Weitere Informationen finden Sie unter D2D1_RENDER_TARGET_PROPERTIES.

dpiY

Typ: FLOAT

Der vertikale DPI des Renderziels. Der Standardwert ist 0,0. Wenn sowohl dpiX als auch dpiY auf 0,0 festgelegt sind, verwendet das Renderziel seinen Standard-DPI. Weitere Informationen finden Sie unter D2D1_RENDER_TARGET_PROPERTIES.

usage

Typ: D2D1_RENDER_TARGET_USAGE

Gibt an, wie das Renderziel remote gerendert wird und ob es GDI-kompatibel sein soll. Der Standardwert D2D1_RENDER_TARGET_USAGE_NONE erstellt ein Renderziel, das nicht mit GDI kompatibel ist und das Direct3D-Befehlsstream-Remoterendering verwendet, sofern verfügbar.

minLevel

Typ: D2D1_FEATURE_LEVEL

Die minimale Direct3D-Featureebene, die für das Hardwarerendering erforderlich ist. Der Standardwert D2D1_FEATURE_LEVEL_DEFAULT gibt an, dass Direct2D bestimmen soll, ob die Direct3D-Featureebene des Geräts angemessen ist. Dieses Feld wird nur verwendet, wenn die Objekte ID2D1HwndRenderTarget und ID2D1DCRenderTarget erstellt werden. Weitere Informationen finden Sie unter D2D1_RENDER_TARGET_PROPERTIES.

Rückgabewert

Typ: D2D1_RENDER_TARGET_PROPERTIES

Eine D2D1_RENDER_TARGET_PROPERTIES , die die angegebenen Einstellungen enthält.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1helper.h
Bibliothek	D2d1.lib
DLL	D2d1.dll

Weitere Informationen

D2D1_RENDER_TARGET_PROPERTIES-Struktur

Unterstützte Pixelformate und Alpha-Modi

Freigeben über