Metodo IDirect3DCubeTexture9::LockRect (d3d9.h)

Articolo
08/23/2023

Blocca un rettangolo in una risorsa trama del cubo.

Sintassi

HRESULT LockRect(
  [in]  D3DCUBEMAP_FACES FaceType,
  [in]  UINT             Level,
  [out] D3DLOCKED_RECT   *pLockedRect,
  [in]  const RECT       *pRect,
  [in]  DWORD            Flags
);

Parametri

[in] FaceType

Tipo: D3DCUBEMAP_FACES

Membro del tipo enumerato D3DCUBEMAP_FACES , identificando un viso mappa cubo.

[in] Level

Tipo: UINT

Specifica un livello di trama del cubo mipmapped.

[out] pLockedRect

Tipo: D3DLOCKED_RECT*

Puntatore a una struttura D3DLOCKED_RECT , che descrive l'area da bloccare.

[in] pRect

Tipo: const RECT*

Puntatore a un rettangolo da bloccare. Specificato da un puntatore a una struttura RECT . La specifica di NULL per questo parametro espande l'area sporca per coprire l'intera trama del cubo.

[in] Flags

Tipo: DWORD

Combinazione di flag di blocco zero o più che descrivono il tipo di blocco da eseguire. Per questo metodo, i flag validi sono:

D3DLOCK_DISCARD
D3DLOCK_NO_DIRTY_UPDATE
D3DLOCK_NOSYSLOCK
D3DLOCK_READONLY

Non è possibile specificare una sottorezione quando si usa D3DLOCK_DISCARD. Per una descrizione dei flag, vedere D3DLOCK.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. D3DERR_INVALIDCALL viene restituito se uno o più argomenti non sono validi.

Commenti

Per motivi di prestazioni, le aree sporche vengono registrate solo per il livello zero di una trama. Le aree sporche vengono registrate automaticamente quando viene chiamato IDirect3DCubeTexture9::LockRect senza D3DLOCK_NO_DIRTY_UPDATE o D3DLOCK_READONLY. Per altre informazioni, vedere IDirect3DDevice9::UpdateTexture .

Le trame del cubo create con D3DPOOL_DEFAULT non sono bloccabili. Le trame del cubo create nella memoria video sono bloccate quando vengono create con USAGE_DYNAMIC.

L'unico formato bloccabile per una trama a stencil profondità è D3DFMT_D16_LOCKABLE.