Método IDirect3DVolumeTexture9::AddDirtyBox (d3d9helper.h)

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

Sintaxis

HRESULT AddDirtyBox(
  [in] const D3DBOX *pDirtyBox
);

Parámetros

[in] pDirtyBox

Tipo: const D3DBOX*

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

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta 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 para el nivel cero de una textura. En el caso de los subniveles, se supone que el cuadro correspondiente (escalado) también está sucio. Las regiones desfasadas se registran automáticamente cuando se llama a LockBox sin D3DLOCK_NO_DIRTY_UPDATE o D3DLOCK_READONLY.

El uso de D3DLOCK_NO_DIRTY_UPDATE y la especificación explícita de regiones desfasadas se pueden usar para aumentar la eficacia de UpdateTexture. Con este método, las aplicaciones pueden optimizar qué subconjunto de un recurso se copia especificando cuadros desfasado en el recurso. Sin embargo, las regiones desfasadas se pueden expandir para optimizar la alineación.

Requisitos

Consulte también

IDirect3DVolumeTexture9