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 |