Metodo IDirect3DVolumeTexture9::LockBox (d3d9helper.h)

Articolo
08/23/2023

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

Per una descrizione dei flag, vedere D3DLOCK.

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


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

Vedi anche

IDirect3DVolumeTexture9

UnlockBox

Condividi tramite