Device.CreateRenderTarget-Methode

Artikel
11/08/2009

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Erstellt eine Renderingzieloberfläche.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Function CreateRenderTarget ( _
    width As Integer, _
    height As Integer, _
    format As Format, _
    multiSampleType As MultiSampleType, _
    lockable As Boolean _
) As Surface
'Usage
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
)

member CreateRenderTarget : 
        width:int * 
        height:int * 
        format:Format * 
        multiSampleType:MultiSampleType * 
        lockable:bool -> Surface

Parameter

width
Typ: System.Int32
Die Breite der Renderingzieloberfläche in Pixel.

height
Typ: System.Int32
Die Höhe der Renderingzieloberfläche in Pixel.

format
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Format
Ein Member des Format Enumerationstyps, der das Format des Renderingziels beschreibt.

multiSampleType
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.MultiSampleType
Ein Mitglied der MultiSampleType Enumerationstyps, der die multisampling-Puffertyp beschreibt.Dieser Parameter gibt den Typ der Antialiasing für das Renderingziel an.Wenn diese Oberfläche an SetRenderTargetübergeben wird, muss der multisample-Typ der Tiefe Schablone-Eigenschaft DepthStencilSurface identisch sein.

lockable
Typ: System.Boolean
Legen Sie auf true, wenn die Renderingziele gesperrt werden; sindandernfalls false.Beachten Sie, dass sperrbare Renderingziele Leistung auf einigen Hardwaregeräten Grafiken reduzieren.

Rückgabewert

Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
A Surface.

Ausnahmen

Ausnahme	Bedingung
NotAvailableException	Das Gerät unterstützt den abgefragten Multisamplingtyp nicht.
InvalidCallException	Der Methodenaufruf ist ungültig.Beispielsweise kann ein Parameter einen ungültigen Wert enthalten.
OutOfMemoryException	Direct3D hat nicht genügend Arbeitsspeicher, um den Anruf nicht abschließen.

Hinweise

Eine Renderingzieloberfläche ist eine Renderingoberfläche.Beispielsweise schreibt ein 3D-Renderer pro Pixel Szenendaten z. B. Farbe, in eine Renderingzieloberfläche.

Renderingziel Oberflächen werden in die Arbeitsspeicherklasse Pool platziert.Die Erstellung von sperrbaren, Multisampling-Renderingzielen wird nicht unterstützt.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Plattformen

Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC

Die .NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET framework.

Versionsinformationen

.NET Compact Framework

Unterstützt in: 3.5, 2.0

Siehe auch

Referenz

Device Klasse

Member Device

Microsoft.WindowsMobile.DirectX.Direct3D-Namespace

Freigeben über