ID2D1RenderTarget：：CreateCompatibleRenderTarget (D2D1_SIZE_F，D2D1_SIZE_U，ID2D1BitmapRenderTarget**) 方法 (d2d1.h)

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

語法

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

參數

desiredSize

類型：[in] D2D1_SIZE_F

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

desiredPixelSize

類型：[in] D2D1_SIZE_U

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

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 符合原始轉譯目標。

這個方法所建立的位圖轉譯目標與 GDI 不相容。

規格需求

另請參閱

ID2D1RenderTarget