Metodo IDirect3DTexture9::AddDirtyRect (d3d9.h)

Aggiunge un'area sporca a una risorsa trama.

Sintassi

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

Parametri

[in] pDirtyRect

Tipo: const RECT*

Puntatore a una struttura RECT , specificando l'area sporca da aggiungere. Se si specifica NULL , l'area sporca viene espansa per coprire l'intera trama.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL.

Commenti

Per motivi di prestazioni, le aree sporche vengono registrate solo per il livello zero di una trama. Per i sublevel, si presuppone che il rettangolo o la casella corrispondente (ridimensionato) sia anche sporco. Le aree sporche vengono registrate automaticamente quando viene chiamato IDirect3DTexture9::LockRect senza D3DLOCK_NO_DIRTY_UPDATE o D3DLOCK_READONLY. La superficie di destinazione di IDirect3DDevice9::UpdateSurface è contrassegnata automaticamente.

È possibile usare D3DLOCK_NO_DIRTY_UPDATE e specificare in modo esplicito le aree sporche per aumentare l'efficienza di IDirect3DDevice9::UpdateTexture. Usando questo metodo, le applicazioni possono ottimizzare il subset di una risorsa copiata specificando aree sporche nella risorsa. Tuttavia, le aree sporche possono essere espanse per ottimizzare l'allineamento.

Requisiti

Vedi anche

IDirect3DTexture9