Device.CreateRenderTarget (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Crea una superficie de destino de representación.

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

Sintaxis

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

Parámetros

width
Tipo: System.Int32
Ancho de la superficie de destino de representación, en píxeles.

height
Tipo: System.Int32
Alto de la superficie de destino de representación, en píxeles.

format
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Format
Miembro del tipo enumerado Format que describe el formato del destino de representación.

multiSampleType
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.MultiSampleType
Miembro del tipo enumerado MultiSampleType que describe el tipo de búfer de muestreo múltiple. Este parámetro especifica el tipo de suavizado del destino de representación. Cuando esta superficie se pasa a SetRenderTarget, su tipo de muestreo múltiple debe ser igual al de la propiedad de estarcido de profundidad DepthStencilSurface.

lockable
Tipo: System.Boolean
Se establece en true si los destinos de representación son bloqueables; de lo contrario, es false. Tenga en cuenta que los destinos de representación bloqueables en algunos casos reducen el rendimiento del hardware de gráficos.

Valor devuelto

Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Surface .

Excepciones

Excepción	Condición
NotAvailableException	El dispositivo no admite el tipo de muestreo múltiple consultado.
InvalidCallException	La llamada al método no es válida. Por ejemplo, puede que un parámetro contenga un valor no válido.
OutOfMemoryException	Direct3D no tiene memoria suficiente para finalizar la llamada.

Comentarios

Una superficie de destino de representación es una superficie de representación. Por ejemplo, un representador 3D escribe los datos de la escena (como el color) píxel a píxel en una superficie de destino de representación.

Las superficies de destino de representación se colocan en la clase de memoria Pool. No se admite la creación de destinos de representación de muestreo múltiple bloqueables.

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