Metodo Device.CreateRenderTarget

Articolo
09/12/2008

Aggiornamento: novembre 2007

Crea una superficie della destinazione di rendering.

Spazio dei nomi: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Sintassi

'Dichiarazione
Public Function CreateRenderTarget ( _
    width As Integer, _
    height As Integer, _
    format As Format, _
    multiSampleType As MultiSampleType, _
    lockable As Boolean _
) As Surface
'Utilizzo
Dim instance As Device
Dim width As Integer
Dim height As Integer
Dim format As Format
Dim multiSampleType As MultiSampleType
Dim lockable As Boolean
Dim returnValue As Surface

returnValue = instance.CreateRenderTarget(width, _
    height, format, multiSampleType, _
    lockable)

public Surface CreateRenderTarget(
    int width,
    int height,
    Format format,
    MultiSampleType multiSampleType,
    bool lockable
)

public:
Surface^ CreateRenderTarget(
    int width, 
    int height, 
    Format format, 
    MultiSampleType multiSampleType, 
    bool lockable
)

public function CreateRenderTarget(
    width : int, 
    height : int, 
    format : Format, 
    multiSampleType : MultiSampleType, 
    lockable : boolean
) : Surface

Parametri

width
Tipo: System.Int32

Larghezza in pixel della superficie della destinazione di rendering.

height
Tipo: System.Int32

Altezza in pixel della superficie della destinazione di rendering.

format
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Format

Membro del tipo enumerato Format che descrive il formato della destinazione di rendering.

multiSampleType
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.MultiSampleType

Membro del tipo enumerato MultiSampleType che descrive il tipo di buffer di campionamento multiplo. Questo parametro specifica il tipo di anti-aliasing per la destinazione di rendering. Quando questa superficie viene passata al metodo SetRenderTarget, il relativo tipo di campionamento multiplo deve corrispondere a quello della proprietà di stencil di profondità DepthStencilSurface.

lockable
Tipo: System.Boolean

Impostare su true se le destinazioni di rendering sono bloccabili; in caso contrario false. Si noti che le destinazioni di rendering bloccabili riducono le prestazioni di alcuni componenti hardware grafici.

Valore restituito

Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Surface

Oggetto Surface.

Eccezioni

Eccezione	Condizione
NotAvailableException	La periferica non supporta il tipo di campionamento multiplo richiesto.
InvalidCallException	La chiamata al metodo non è valida. Un parametro potrebbe, ad esempio, contenere un valore non valido.
OutOfMemoryException	In Direct3D non è disponibile memoria sufficiente per completare la chiamata.

Note

Una superficie di destinazione di rendering è una superficie di rendering. Un renderer 3D, ad esempio, scrive i dati di scena (colore) per ogni singolo pixel su una superficie di destinazione di rendering.

Le superfici di destinazione di rendering sono inserite nella classe di memoria Pool. Non è possibile creare destinazioni di rendering bloccabili e di campionamento multiplo.

Autorizzazioni

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Piattaforme

Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione

.NET Compact Framework

Supportato in: 3.5, 2.0

Vedere anche

Riferimenti

Device Classe

Membri Device

Spazio dei nomi Microsoft.WindowsMobile.DirectX.Direct3D

Condividi tramite