Compartir a través de


Método IDirect3DTexture9::AddDirtyRect (d3d9helper.h)

Agrega una región desfasada a un recurso de textura.

Sintaxis

HRESULT AddDirtyRect(
  [in] const RECT *pDirtyRect
);

Parámetros

[in] pDirtyRect

Tipo: const RECT*

Puntero a una estructura RECT , especificando la región desfasada que se va a agregar. Al especificar NULL , se expande la región desfasada para cubrir toda la textura.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto se puede D3DERR_INVALIDCALL.

Comentarios

Por motivos de rendimiento, las regiones desfasadas solo se registran en el nivel cero de una textura. En el caso de los subniveles, se supone que el rectángulo o el cuadro correspondientes también están sucios. Las regiones desfasadas se registran automáticamente cuando se llama a IDirect3DTexture9::LockRect sin D3DLOCK_NO_DIRTY_UPDATE ni D3DLOCK_READONLY. La superficie de destino de IDirect3DDevice9::UpdateSurface también se marca automáticamente.

Se puede usar D3DLOCK_NO_DIRTY_UPDATE y especificar explícitamente regiones desfasadas para aumentar la eficacia de IDirect3DDevice9::UpdateTexture. Con este método, las aplicaciones pueden optimizar qué subconjunto de un recurso se copia especificando regiones desfasadas en el recurso. Sin embargo, las regiones desfasadas se pueden expandir para optimizar la alineación.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d9helper.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

IDirect3DTexture9