Metodo IDirect3DCubeTexture9::LockRect (d3d9helper.h)

Articolo
03/05/2024

Blocca un rettangolo su una risorsa trama 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 D3DCUBEMAP_FACES tipo enumerato, identificando una faccia della mappa del 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 . Se si specifica NULL per questo parametro, l'area dirty viene espansa per coprire l'intera trama del cubo.

[in] Flags

Tipo: DWORD

Combinazione di zero o più flag di blocco 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 sottosezione 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 viene D3D_OK. D3DERR_INVALIDCALL viene restituito se uno o più argomenti non sono validi.

Commenti

Per motivi di prestazioni, le aree dirty vengono registrate solo per il livello zero di una trama. Le aree dirty 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 bloccabili quando vengono create con USAGE_DYNAMIC.

L'unico formato bloccabile per una trama depth-stencil è D3DFMT_D16_LOCKABLE.