RenderTargetProperties 函式 (d2d1helper.h)

建立 D2D1_RENDER_TARGET_PROPERTIES 結構。

語法

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
);

參數

type

類型： D2D1_RENDER_TARGET_TYPE

值，指定轉譯目標是否必須使用硬體轉譯或軟體轉譯。 預設值 D2D1_RENDER_TARGET_TYPE_DEFAULT指定使用硬體轉譯;如果無法使用硬體轉譯，則轉譯目標會使用軟體轉譯。 請注意，WIC 點陣圖轉譯目標不支援硬體轉譯。

[in] pixelFormat

類型：const D2D1_PIXEL_FORMAT

轉譯目標的像素格式和 Alpha 模式。 預設像素格式為 D2D1：:P ixelFormat，告知 Direct2D 選取轉譯目標支援的像素格式。 如需每個轉譯目標所支援的像素格式和 Alpha 模式清單，請參閱 支援的像素格式和 Alpha 模式。

dpiX

類型： FLOAT

轉譯目標的水準 DPI。 預設值為 0.0。 如果 DPIX 和 DPIY 都設定為 0.0，則轉譯目標會使用其預設 DPI。 如需詳細資訊，請參閱 D2D1_RENDER_TARGET_PROPERTIES。

dpiY

類型： FLOAT

轉譯目標的垂直 DPI。 預設值為 0.0。 如果 DPIX 和 DPIY 都設定為 0.0，則轉譯目標會使用其預設 DPI。 如需詳細資訊，請參閱 D2D1_RENDER_TARGET_PROPERTIES。

usage

類型： D2D1_RENDER_TARGET_USAGE

指定轉譯目標從遠端轉譯的方式，以及它是否應該與 GDI 相容。 預設值 D2D1_RENDER_TARGET_USAGE_NONE會建立與 GDI 不相容且使用 Direct3D 命令資料流程遠端轉譯的轉譯目標，如果有的話。

minLevel

類型： D2D1_FEATURE_LEVEL

硬體轉譯所需的最低 Direct3D 功能層級。 預設值 D2D1_FEATURE_LEVEL_DEFAULT指出 Direct2D 應該判斷裝置的 Direct3D 功能層級是否足夠。 只有在建立 ID2D1HwndRenderTarget 和 ID2D1DCRenderTarget 物件時，才會使用此欄位。 如需詳細資訊，請參閱 D2D1_RENDER_TARGET_PROPERTIES。

傳回值

類型： D2D1_RENDER_TARGET_PROPERTIES

包含指定之設定 的D2D1_RENDER_TARGET_PROPERTIES 。

規格需求

最低支援的用戶端	適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	d2d1helper.h
程式庫	D2d1.lib
Dll	D2d1.dll

另請參閱

D2D1_RENDER_TARGET_PROPERTIES 結構

支援的像素格式和 Alpha 模式