Metodo ID2D1Factory::CreateDxgiSurfaceRenderTarget(IDXGISurface*,constD2D1_RENDER_TARGET_PROPERTIES&,ID2D1RenderTarget**) (d2d1.h)
Crea una destinazione di rendering che disegna su una superficie DXGI (DirectX Graphics Infrastructure).
Sintassi
HRESULT CreateDxgiSurfaceRenderTarget(
[in] IDXGISurface *dxgiSurface,
[ref] const D2D1_RENDER_TARGET_PROPERTIES & renderTargetProperties,
[out] ID2D1RenderTarget **renderTarget
);
Parametri
[in] dxgiSurface
Tipo: IDXGISurface*
IDXGISurface in cui verrà disegnare la destinazione di rendering.
[ref] 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
Per scrivere in una superficie Direct3D, ottenere un IDXGISurface e passarlo al metodo CreateDxgiSurfaceRenderTarget per creare una destinazione di rendering della superficie DXGI; è quindi possibile usare la destinazione di rendering della superficie DXGI per disegnare contenuto 2D sulla superficie DXGI.
Una destinazione di rendering della superficie DXGI è un tipo di ID2D1RenderTarget. Analogamente ad altre destinazioni di rendering Direct2D, è possibile usarla per creare risorse ed eseguire comandi di disegno.
La destinazione di rendering della superficie DXGI e la superficie DXGI devono usare lo stesso formato DXGI. Se si specifica il formato di DXGI_FORMAT_UNKOWN quando si crea la destinazione di rendering, verrà utilizzato automaticamente il formato della superficie.
La destinazione di rendering della superficie DXGI non esegue la sincronizzazione della superficie DXGI.
Per altre informazioni sulla creazione e sull'uso di destinazioni di rendering della superficie DXGI, vedere Panoramica dell'interoperabilità direct2D e Direct3D.
Per usare Direct2D, il dispositivo Direct3D che fornisce IDXGISurface deve essere creato con il flag D3D10_CREATE_DEVICE_BGRA_SUPPORT .
Quando si crea una destinazione di rendering e l'accelerazione hardware è disponibile, allocare risorse nella GPU del computer. Creando una destinazione di rendering una sola volta e conservandola il più a lungo possibile, si ottengono vantaggi in termini di prestazioni. L'applicazione deve creare destinazioni di rendering una sola volta e mantenerle per la durata dell'applicazione o fino a quando il metodo EndDraw della destinazione di rendering non restituisce l'errore D2DERR_RECREATE_TARGET . Quando viene visualizzato questo errore, è necessario ricreare la destinazione di rendering e tutte le risorse create.
Esempio
Vedere l'esempio di codice in ID2D1Factory::CreateDxgiSurfaceRenderTarget.
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
CreateDxgiSurfaceRenderTarget(IDXGISurface,const D2D1_RENDER_TARGET_PROPERTIES,ID2D1RenderTarget)