Share via

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

  • Artigo

Bloqueia uma caixa em um recurso de volume.

Sintaxe

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

Parâmetros

[out] pLockedVolume

Tipo: D3DLOCKED_BOX*

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

[in] pBox

Tipo: const D3DBOX*

Ponteiro para uma caixa a ser bloqueada. Especificado por um ponteiro para uma estrutura D3DBOX . Especificar NULL para esse parâmetro bloqueia todo o 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 IDirect3DVolume9::LockBox é chamado sem D3DLOCK_NO_DIRTY_UPDATE ou D3DLOCK_READONLY. Consulte IDirect3DDevice9::UpdateTexture para obter mais informações.

Requisitos

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

Confira também

IDirect3DVolume9

IDirect3DVolume9::UnlockBox