Device.SetRenderTarget Method

Artículo
12/12/2007

Sets a new color buffer for a device.

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
)

public void SetRenderTarget (
    Surface renderTarget, 
    Surface newZStencil
)

public function SetRenderTarget (
    renderTarget : Surface, 
    newZStencil : Surface
)

Not applicable.

Parameters

renderTarget
An index Surface of the render target.

newZStencil
A new color buffer Surface. If set to a null reference (Nothing in Visual Basic), the color buffer for the corresponding renderTarget is disabled. Devices must always be associated with a color buffer.

The new render-target surface must have at least Usage specified.

Exceptions

Exception type	Condition
InvalidCallException	The method call is invalid. Either renderTarget is a null reference (Nothing in Visual Basic)and newZStencil = 0, or renderTarget is not a null reference (Nothing in Visual Basic)and the render target is invalid.

Remarks

The device can support multiple render targets. Some hardware tests the compatibility of the depth stencil buffer with the color buffer. If this is done, it is done only in a debug build. The following restrictions apply when using this method:

The MultiSampleType type must be the same for the render target and the depth stencil surface.
The formats must be compatible for the render target and the depth stencil surface. For more information, see CheckDepthStencilMatch.
The size of the depth stencil surface must be greater than or equal to the size of the render target.

These restrictions are validated only when using the debug runtime when any of the Device drawing methods are called.

Platforms

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Compact Framework

Supported in: 2.0

Compartir a través de