RenderTargetProperties-Funktion (d2d1helper.h)
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
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
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 |