Método IDirect3DCubeTexture9::LockRect (d3d9.h)

Artigo
08/23/2023

Bloqueia um retângulo em um recurso de textura de cubo.

Sintaxe

HRESULT LockRect(
  [in]  D3DCUBEMAP_FACES FaceType,
  [in]  UINT             Level,
  [out] D3DLOCKED_RECT   *pLockedRect,
  [in]  const RECT       *pRect,
  [in]  DWORD            Flags
);

Parâmetros

[in] FaceType

Tipo: D3DCUBEMAP_FACES

Membro do tipo enumerado D3DCUBEMAP_FACES , identificando uma face de mapa de cubo.

[in] Level

Tipo: UINT

Especifica um nível de uma textura de cubo mipmapped.

[out] pLockedRect

Tipo: D3DLOCKED_RECT*

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

[in] pRect

Tipo: const RECT*

Ponteiro para um retângulo a ser bloqueado. Especificado por um ponteiro para uma estrutura RECT . Especificar NULL para esse parâmetro expande a região sujo para cobrir toda a textura do cubo.

[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

Talvez você não especifique uma subreção ao usar D3DLOCK_DISCARD. 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. D3DERR_INVALIDCALL será retornado se um ou mais argumentos forem inválidos.

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 IDirect3DCubeTexture9::LockRect é chamado sem D3DLOCK_NO_DIRTY_UPDATE ou D3DLOCK_READONLY. Consulte IDirect3DDevice9::UpdateTexture para obter mais informações.

Texturas de cubo criadas com D3DPOOL_DEFAULT não são bloqueáveis. As texturas de cubo criadas na memória de vídeo são bloqueáveis quando criadas com USAGE_DYNAMIC.

O único formato bloqueável para uma textura de estêncil de profundidade é D3DFMT_D16_LOCKABLE.