Metodo IDirect3DTexture9::AddDirtyRect (d3d9helper.h)

Aggiunge un'area dirty 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 dirty da aggiungere. Se si specifica NULL , l'area dirty viene espansa per coprire l'intera trama.

Valore restituito

Tipo: HRESULT

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

Commenti

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

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

Requisiti

Vedi anche

IDirect3DTexture9