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 |