ID2D1DeviceContext：：GetTarget 方法 (d2d1_1.h)

取得目前與裝置內容相關聯的目標。

語法

void GetTarget(
  [out, optional] ID2D1Image **image
);

參數

[out, optional] image

類型： ID2D1Image**

當這個方法傳回時，會包含目前與裝置內容相關聯之目標的指標位址。

傳回值

無

備註

如果目標未與裝置內容相關聯，當方法傳回時 ，目標 會包含 NULL 。

如果目前選取的目標是點陣陣圖，而不是命令清單，應用程式可以使用下列其中一種方法來取得初始點陣圖的存取權：

• CreateHwndRenderTarget
• CreateDxgiSurfaceRenderTarget
• CreateWicBitmapRenderTarget
• CreateDCRenderTarget
• CreateCompatibleRenderTarget

應用程式無法終結這些點陣圖。 所有這些點陣圖都可以系結為位圖目標。 不過，並非所有這些點陣圖都可以當做 ID2D1RenderTarget 方法的點陣圖來源使用。

如果 DXGI 表面可系結為著色器資源檢視，CreateDxgiSurfaceRenderTarget 將會建立可當做位圖來源使用的位圖。

CreateCompatibleRenderTarget 一律會建立可做為位圖來源的位圖。

ID2D1RenderTarget：：BeginDraw 會從 HDC 複製到與其相關聯的原始位圖。 ID2D1RenderTarget：：EndDraw 會從原始位圖複製到 HDC。

在下列情況下，IWICBitmap 物件將會鎖定：

• BeginDraw 已呼叫，且目前選取的目標位圖是 WIC 位圖。
• 在呼叫 BeginDraw 之後，以及在呼叫 EndDraw 之前，WIC 位圖會設定為裝置內容的目標。
• 任何 ID2D1Bitmap：：Copy* 方法都是使用 WIC 位圖作為來源或目的地來呼叫。

在下列情況下，IWICBitmap 物件將會解除鎖定：

• EndDraw 稱為 ，且目前選取的目標位圖是 WIC 位圖。
• WIC 位圖會在呼叫 BeginDraw 和 EndDraw 之間，移除為裝置內容的目標。
• 任何 ID2D1Bitmap：：Copy* 方法都是使用 WIC 位圖作為來源或目的地來呼叫。

Direct2D 只會鎖定目前未鎖定的點陣圖。

呼叫 ID2D1GdiInteropRenderTarget 的 QueryInterface 一律會成功。 ID2D1GdiInteropRenderTarget：：GetDC 會傳回對應至目前系結目標位圖的裝置內容。 如果未使用設定GDI_COMPATIBLE旗標來建立目標位圖，GetDC 將會失敗。

ID2D1HwndRenderTarget：：Resize 會 傳回DXGI_ERROR_INVALID_CALL ，如果與轉譯目標相關聯的原始目標位圖有任何未完成的參考。

雖然目標可以是命令清單，但不能是其他類型的影像。 它不能是效果的輸出影像。

規格需求

需求	值
最低支援的用戶端	適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	d2d1_1.h
Dll	D2d1.dll

另請參閱

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext：：CreateBitmap

ID2D1DeviceContext：：SetTarget