ID2D1RenderTarget：：CreateCompatibleRenderTarget (constD2D1_SIZE_F*，constD2D1_SIZE_U*，constD2D1_PIXEL_FORMAT*，D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS，ID2D1BitmapRenderTarget**) 方法 (d2d1.h)

  • 發行項

建立位圖轉譯目標，以在與目前轉譯目標相容的中繼離螢幕繪圖期間使用。

語法

HRESULT CreateCompatibleRenderTarget(
  const D2D1_SIZE_F                     *desiredSize,
  const D2D1_SIZE_U                     *desiredPixelSize,
  const D2D1_PIXEL_FORMAT               *desiredFormat,
  D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
  ID2D1BitmapRenderTarget               **bitmapRenderTarget
);

參數

desiredSize

類型： [in] const D2D1_SIZE_F*

如果新轉譯目標的大小與原始轉譯目標不同，) 以裝置無關的圖元 (。 如需詳細資訊，請參閱一節。

desiredPixelSize

類型：[in] const D2D1_SIZE_U*

如果新轉譯目標的大小應該與原始轉譯目標不同，則以圖元為單位。 如需詳細資訊，請參閱＜備註＞一節。

desiredFormat

類型：[in] const D2D1_PIXEL_FORMAT*

新轉譯目標所需的圖元格式和 Alpha 模式。 如果圖元格式設定為DXGI_FORMAT_UNKNOWN，新的轉譯目標會使用與原始轉譯目標相同的圖元格式。 如果alpha模式 D2D1_ALPHA_MODE_UNKNOWN，則新轉譯目標的Alpha模式預設為 D2D1_ALPHA_MODE_PREMULTIPLIED。 如需支援圖元格式的資訊，請參閱 支援的圖元格式和 Alpha 模式。

options

類型：[in] D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS

值，指定新的轉譯目標是否必須與 GDI 相容。

bitmapRenderTarget

類型： [out] ID2D1BitmapRenderTarget**

當這個方法傳回時，包含新位圖轉譯目標的指標指標。 這個參數會以未初始化的狀態傳遞。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

您可以藉由指定 desiredSize 或 desiredPixelSize 的值來改變新轉譯目標的圖元大小和 DPI：

  • 如果指定 desiredSize 但 desiredPixelSize 不是，則會使用父目標 DPI 從所需的大小計算圖元大小。 如果 desiredSize 對應至整數圖元大小，相容轉譯目標的 DPI 與父目標的 DPI 相同。 如果 desiredSize 對應至小數圖元大小，圖元大小會四捨五入為最接近的整數，且相容轉譯目標的 DPI 稍微高於父轉譯目標的 DPI。 在所有情況下，座標 (desiredSize.width，desiredSize.height) 對應至相容轉譯目標的右下角。
  • 如果指定 desiredPixelSize 且 desiredSize 不是，則新轉譯目標的 DPI 與原始轉譯目標相同。
  • 如果同時指定 desiredSize 和 desiredPixelSize ，則會計算新轉譯目標的 DPI，以考慮縮放比例的差異。
  • 如果未指定 desiredSize 或 desiredPixelSize ，則新的轉譯目標大小和 DPI 符合原始轉譯目標。

規格需求

需求 值
目標平台 Windows
標頭 d2d1.h
程式庫 D2d1.lib
Dll D2d1.dll

另請參閱

ID2D1RenderTarget