ID2D1Factory：：CreateWicBitmapRenderTarget (IWICBitmap*，constD2D1_RENDER_TARGET_PROPERTIES*，ID2D1RenderTarget**) 方法 (d2d1.h)

  • 發行項

建立轉譯目標，此轉譯目標會轉譯為 Microsoft Windows 圖像處理元件 (WIC) 位陣圖。

語法

HRESULT CreateWicBitmapRenderTarget(
  [in]  IWICBitmap                          *target,
  [in]  const D2D1_RENDER_TARGET_PROPERTIES *renderTargetProperties,
  [out] ID2D1RenderTarget                   **renderTarget
);

參數

[in] target

類型： IWICBitmap*

接收轉譯目標之轉譯輸出的點陣圖。

[in] renderTargetProperties

類型： const D2D1_RENDER_TARGET_PROPERTIES*

轉譯模式、圖元格式、遠端選項、DPI 資訊，以及硬體轉譯所需的最低 DirectX 支援。 如需支援圖元格式的資訊，請參閱 支援的圖元格式和 Alpha 模式。

[out] renderTarget

類型： ID2D1RenderTarget**

當這個方法傳回時，會包含這個方法所建立 之ID2D1RenderTarget 物件的指標位址。

傳回值

類型： HRESULT

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

備註

您必須針對 renderTargetProperties 參數的 minLevel 成員搭配此方法使用 D2D1_FEATURE_LEVEL_DEFAULT。

您的應用程式應該建立轉譯目標一次，並在應用程式存留期間或直到收到 D2DERR_RECREATE_TARGET 錯誤為止。 當您收到此錯誤時，您必須重新建立轉譯目標 (及其) 建立的任何資源。

注意

Windows Phone 不支援此方法，且會在裝置上呼叫時失敗，並出現錯誤碼0x8899000b (「沒有硬體轉譯裝置可供此作業使用」) 。 因為 Windows Phone 模擬器支援 WARP 轉譯，所以在模擬器上呼叫時，此方法會失敗，並出現不同的錯誤碼，0x88982f80 (wincodec_err_unsupportedpixelformat) 。

規格需求

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

另請參閱

ID2D1Factory