SwapChain.Present (Método) (Rectangle, Boolean)

Artículo
11/26/2008

Actualización: noviembre 2007

Muestra el contenido del siguiente búfer en la secuencia de búferes de reserva que posee la cadena de intercambio.

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

Sintaxis

'Declaración
Public Sub Present ( _
    rectPresent As Rectangle, _
    sourceRectangle As Boolean _
)
'Uso
Dim instance As SwapChain
Dim rectPresent As Rectangle
Dim sourceRectangle As Boolean

instance.Present(rectPresent, sourceRectangle)

public void Present(
    Rectangle rectPresent,
    bool sourceRectangle
)

public:
void Present(
    Rectangle rectPresent, 
    bool sourceRectangle
)

public function Present(
    rectPresent : Rectangle, 
    sourceRectangle : boolean
)

Parámetros

rectPresent
Tipo: System.Drawing.Rectangle
Estructura Rectangle que contiene el rectángulo de origen. Este valor se debe omitir a menos que la cadena de intercambio se creara utilizando Copy con SwapEffect. Si se omite el valor, se presenta la superficie de origen completa. Si el rectángulo excede la superficie de origen, se recorta para ajustarlo a ella.

sourceRectangle
Tipo: System.Boolean
Se establece en true si se va a pasar Rectangle al parámetro rectPresent; de lo contrario, es false.

Excepciones

Excepción	Condición
DriverInternalErrorException	Error interno del controlador. Las aplicaciones deben, por lo general, cerrarse al recibir este error.
InvalidCallException	La llamada al método no es válida. Por ejemplo, puede que un parámetro del método contenga un valor no válido.
OutOfMemoryException	Direct3D no pudo asignar memoria suficiente para completar la llamada.

Comentarios

Este método es un acceso directo al método Present de Device. El método de la cadena de intercambio se ha actualizado para incluir un indicador que permite a la aplicación solicitar que el método regrese inmediatamente cuando el controlador informe de que no puede programar una presentación.

Si es necesario, se aplica una operación de expansión para transferir los píxeles del interior del rectángulo de origen al rectángulo de destino en el área de cliente de la ventana de destino.

El método Present de Device genera un error si se llama entre su par de métodos BeginScene y EndScene, a menos que el destino de representación no sea el destino de representación actual, como el búfer de reserva que se obtiene de la creación de una cadena de intercambio adicional.

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.