Compartilhar via


Método IDirect3DVolumeTexture9::LockBox (d3d9helper.h)

Bloqueia uma caixa em um recurso de textura de volume.

Sintaxe

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

Parâmetros

[in] Level

Tipo: UINT

Especifica o nível do recurso de textura de volume a ser bloqueado.

[out] pLockedVolume

Tipo: D3DLOCKED_BOX*

Ponteiro para uma estrutura D3DLOCKED_BOX , descrevendo a região bloqueada.

[in] pBox

Tipo: const D3DBOX*

Ponteiro para o volume a ser bloqueado. Esse parâmetro é especificado por um ponteiro para uma estrutura D3DBOX . Especificar NULL para esse parâmetro bloqueia todo o nível de volume.

[in] Flags

Tipo: DWORD

Combinação de zero ou mais sinalizadores de bloqueio que descrevem o tipo de bloqueio a ser executado. Para esse método, os sinalizadores válidos são:

  • D3DLOCK_DISCARD
  • D3DLOCK_NO_DIRTY_UPDATE
  • D3DLOCK_NOSYSLOCK
  • D3DLOCK_READONLY
Para obter uma descrição dos sinalizadores, consulte D3DLOCK.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser D3DERR_INVALIDCALL.

Comentários

Por motivos de desempenho, sujo regiões são registradas apenas para o nível zero de uma textura. Regiões sujas são registradas automaticamente quando LockBox é chamado sem D3DLOCK_NO_DIRTY_UPDATE ou D3DLOCK_READONLY. Para obter mais informações, consulte UpdateTexture.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DVolumeTexture9

UnlockBox