Método IDirect3DDevice9::P resent (d3d9.h)

Artículo
08/23/2023

Presenta el contenido del siguiente búfer en la secuencia de búferes de reserva propiedad del dispositivo.

Sintaxis

HRESULT Present(
  [in] const RECT    *pSourceRect,
  [in] const RECT    *pDestRect,
  [in] HWND          hDestWindowOverride,
  [in] const RGNDATA *pDirtyRegion
);

Parámetros

[in] pSourceRect

Tipo: const RECT*

Puntero a un valor que debe ser NULL a menos que la cadena de intercambio se haya creado con D3DSWAPEFFECT_COPY. pSourceRect es un puntero a una estructura RECT que contiene el rectángulo de origen. Si es NULL, se presenta toda la superficie de origen. Si el rectángulo supera la superficie de origen, el rectángulo se recorta en la superficie de origen.

[in] pDestRect

Tipo: const RECT*

Puntero a un valor que debe ser NULL a menos que la cadena de intercambio se haya creado con D3DSWAPEFFECT_COPY. pDestRect es un puntero a una estructura RECT que contiene el rectángulo de destino, en coordenadas de cliente de ventana. Si es NULL, se rellena todo el área de cliente. Si el rectángulo supera el área cliente de destino, el rectángulo se recorta en el área de cliente de destino.

[in] hDestWindowOverride

Tipo: HWND

Puntero a una ventana de destino cuyo área de cliente se toma como destino para esta presentación. Si este valor es NULL, el tiempo de ejecución usa el miembro hDeviceWindow de D3DPRESENT_PARAMETERS para la presentación.

[in] pDirtyRegion

Tipo: const RGNDATA*

El valor debe ser NULL a menos que la cadena de intercambio se haya creado con D3DSWAPEFFECT_COPY. Para obtener más información sobre las cadenas de intercambio, consulta Voltear superficies (Direct3D 9) y D3DSWAPEFFECT. Si este valor no es NULL, la región contenida se expresa en coordenadas de búfer de reserva. Los rectángulos dentro de la región son el conjunto mínimo de píxeles que deben actualizarse. Este método tiene en cuenta estos rectángulos al optimizar la presentación copiando solo los píxeles dentro de la región, o algún conjunto de rectángulos adecuadamente expandido. Se trata de una ayuda solo para la optimización y la aplicación no debe depender de la región que se copia exactamente. La implementación puede elegir copiar todo el rectángulo de origen.

Valor devuelto

Tipo: HRESULT

Entre los valores devueltos posibles se incluyen: D3D_OK o D3DERR_DEVICEREMOVED (consulte D3DERR).

Comentarios

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

Se producirá un error en la presentación, devolviendo D3DERR_INVALIDCALL, si se llama entre los pares BeginScene y EndScene, a menos que el destino de representación no sea el destino de representación actual (por ejemplo, el búfer de reserva que obtiene al crear una cadena de intercambio adicional). Este es un nuevo comportamiento para Direct3D 9.