Metodo ID2D1Factory::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES*,ID2D1RenderTarget**) (d2d1.h)

Crea una destinazione di rendering che esegue il rendering in una bitmap di Microsoft Windows Imaging Component (WIC).

Sintassi

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

Parametri

[in] target

Tipo: IWICBitmap*

Bitmap che riceve l'output di rendering della destinazione di rendering.

[in] renderTargetProperties

Tipo: const D2D1_RENDER_TARGET_PROPERTIES*

La modalità di rendering, il formato pixel, le opzioni di comunicazione remota, le informazioni DPI e il supporto minimo di DirectX necessario per il rendering hardware. Per informazioni sui formati pixel supportati, vedere Formati pixel supportati e modalità alfa.

[out] renderTarget

Tipo: ID2D1RenderTarget**

Quando termina, questo metodo contiene l'indirizzo del puntatore all'oggetto ID2D1RenderTarget creato da questo metodo.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È necessario utilizzare D2D1_FEATURE_LEVEL_DEFAULT per il membro minLevel del parametro renderTargetProperties con questo metodo.

L'applicazione deve creare destinazioni di rendering una sola volta e mantenerle per la durata dell'applicazione o fino a quando non viene ricevuto l'errore di D2DERR_RECREATE_TARGET . Quando viene visualizzato questo errore, è necessario ricreare la destinazione di rendering e tutte le risorse create.

Nota

Questo metodo non è supportato in Windows Phone e avrà esito negativo quando viene chiamato in un dispositivo con codice di errore 0x8899000b ("Non è disponibile alcun dispositivo di rendering hardware per questa operazione"). Poiché l'emulatore Windows Phone supporta il rendering WARP, questo metodo avrà esito negativo quando viene chiamato nell'emulatore con un codice di errore diverso, 0x88982f80 (wincodec_err_unsupportedpixelformat).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1.h
Libreria	D2d1.lib
DLL	D2d1.dll

Vedi anche

ID2D1Factory