Metodo IDirect3DVolumeTexture9::LockBox (d3d9helper.h)

Blocca una casella su una risorsa trama del volume.

Sintassi

HRESULT LockBox(
  [in]  UINT          Level,
  [out] D3DLOCKED_BOX *pLockedVolume,
  [in]  const D3DBOX  *pBox,
  [in]  DWORD         Flags
);

Parametri

[in] Level

Tipo: UINT

Specifica il livello della risorsa trama del volume da bloccare.

[out] pLockedVolume

Tipo: D3DLOCKED_BOX*

Puntatore a una struttura D3DLOCKED_BOX , che descrive l'area bloccata.

[in] pBox

Tipo: const D3DBOX*

Puntatore al volume da bloccare. Questo parametro viene specificato da un puntatore a una struttura D3DBOX . Se si specifica NULL per questo parametro, l'intero livello del volume viene bloccato.

[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

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. Le aree dirty vengono registrate automaticamente quando LockBox viene chiamato senza D3DLOCK_NO_DIRTY_UPDATE o D3DLOCK_READONLY. Per altre informazioni, vedere UpdateTexture.

Requisiti

Vedi anche

IDirect3DVolumeTexture9

UnlockBox