Condividi tramite


Metodo IDirect3DVolume9::LockBox (d3d9helper.h)

Blocca una casella in una risorsa del volume.

Sintassi

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

Parametri

[out] pLockedVolume

Tipo: D3DLOCKED_BOX*

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

[in] pBox

Tipo: const D3DBOX*

Puntatore a una casella da bloccare. Specificato da un puntatore a una struttura D3DBOX . Se si specifica NULL per questo parametro, l'intero volume viene bloccato.

[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
Per una descrizione dei flag, vedere D3DLOCK.

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

Requisiti

   
Piattaforma di destinazione Windows
Intestazione d3d9helper.h (include D3D9.h)
Libreria D3D9.lib

Vedi anche

IDirect3DVolume9

IDirect3DVolume9::UnlockBox