共用方式為


ID2D1Factory::CreateWicBitmapRenderTarget (IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES&,ID2D1RenderTarget**) 方法 (d2d1.h)

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

語法

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

參數

[in] target

類型: IWICBitmap*

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

[ref] 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