Device.SetRenderTarget-Methode
Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]
Legt einen neuen Farbpuffer für ein Gerät.
Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)
Syntax
'Declaration
Public Sub SetRenderTarget ( _
renderTarget As Surface, _
newZStencil As Surface _
)
'Usage
Dim instance As Device
Dim renderTarget As Surface
Dim newZStencil As Surface
instance.SetRenderTarget(renderTarget, _
newZStencil)
public void SetRenderTarget(
Surface renderTarget,
Surface newZStencil
)
public:
void SetRenderTarget(
Surface^ renderTarget,
Surface^ newZStencil
)
member SetRenderTarget :
renderTarget:Surface *
newZStencil:Surface -> unit
Parameter
- renderTarget
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Ein Index Surface des Renderingziels.
- newZStencil
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Eine neue Farbe Puffer Surface.Wenn festgelegt, nullNULL-Verweis (Nothing in Visual Basic)Farbpuffer für das entsprechende renderTarget deaktiviert ist.Geräten müssen immer ein Farbpuffer zugeordnet sein.
Die neue Renderingzieloberfläche muss mindestens Usage angegeben.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidCallException | Der Methodenaufruf ist ungültig.Entweder renderTargetnull und newZStencil ist = 0, oder renderTarget ist nicht null und das Renderingziel ist ungültig. |
Hinweise
Das Gerät kann mehrere Renderingziele unterstützen.Einige Hardware testet die Kompatibilität der Tiefenstencilpuffer mit dem Farbpuffer.Wenn dies geschehen ist, wird es nur in einem Debugbuild ausgeführt.Bei Verwendung dieser Methode gelten die folgenden Einschränkungen:
MultiSampleType Typ muss für das Renderingziel und die Tiefenstenciloberfläche identisch sein.
Die Formate für das Renderingziel und die Tiefenstenciloberfläche müssen übereinstimmen.Weitere Informationen finden Sie unter CheckDepthStencilMatch.
Die Größe der Tiefenstenciloberfläche muss größer oder gleich der Größe des Renderingziels sein.
Diese Einschränkungen werden validiert, nur wenn die Debuglaufzeit verwenden, wenn eine der Device Zeichnung Methoden aufgerufen werden.
.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