Device.SetRenderTarget (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Establece un nuevo búfer de color para un dispositivo.

Espacio de nombres: Microsoft.WindowsMobile.DirectX.Direct3D
Ensamblado: Microsoft.WindowsMobile.DirectX (en Microsoft.WindowsMobile.DirectX.dll)

Sintaxis

'Declaración
Public Sub SetRenderTarget ( _
    renderTarget As Surface, _
    newZStencil As Surface _
)
'Uso
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 function SetRenderTarget(
    renderTarget : Surface, 
    newZStencil : Surface
)

Parámetros

renderTarget
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Índice Surface del destino de representación.

newZStencil
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Nuevo Surface de búfer de color. Si se establece en nullreferencia null (Nothing en Visual Basic), se deshabilita el búfer de color del renderTarget correspondiente. Los dispositivos siempre se deben asociar a un búfer de color.
La nueva superficie de destino de representación al menos debe tener Usage especificado.

Excepciones

Excepción	Condición
InvalidCallException	La llamada al método no es válida. renderTarget es null y newZStencil es igual a 0, o renderTarget no es null y el destino de representación no es válido.

Comentarios

El dispositivo puede admitir varios destinos de representación. En algunos casos, el hardware comprueba la compatibilidad del búfer de estarcido de profundidad con el búfer de color. Si se hace, se hace solamente en una versión de depuración. Al utilizar este método, se aplican las siguientes restricciones:

El tipo MultiSampleType debe ser el mismo para el destino de representación y la superficie de estarcido de profundidad.
Los formatos del destino de representación y de la superficie de estarcido de profundidad deben ser compatibles. Para obtener más información, vea CheckDepthStencilMatch.
El tamaño de la superficie de estarcido de profundidad debe ser mayor o igual que el tamaño del destino de representación.

Estas restricciones sólo se validan al utilizar el motor en tiempo de ejecución de depuración cuando se llama a alguno de los métodos de dibujo de Device.

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Plataformas

Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Compact Framework

Compatible con: 3.5, 2.0

Vea también

Referencia

Device (Clase)

Device (Miembros)

Microsoft.WindowsMobile.DirectX.Direct3D (Espacio de nombres)

Share via