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 |