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

Bloquea un cuadro en un recurso de textura de volumen.

Sintaxis

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

Parámetros

[in] Level

Tipo: UINT

Especifica el nivel del recurso de textura de volumen que se va a bloquear.

[out] pLockedVolume

Tipo: D3DLOCKED_BOX*

Puntero a una estructura de D3DLOCKED_BOX , que describe la región bloqueada.

[in] pBox

Tipo: const D3DBOX*

Puntero al volumen que se va a bloquear. Este parámetro lo especifica un puntero a una estructura D3DBOX . Si se especifica NULL para este parámetro, se bloquea todo el nivel de volumen.

[in] Flags

Tipo: DWORD

Combinación de cero o más marcas de bloqueo que describen el tipo de bloqueo que se va a realizar. Para este método, las marcas válidas son:

• D3DLOCK_DISCARD
• D3DLOCK_NO_DIRTY_UPDATE
• D3DLOCK_NOSYSLOCK
• D3DLOCK_READONLY

Para obtener una descripción de las marcas, consulte D3DLOCK.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto se puede D3DERR_INVALIDCALL.

Comentarios

Por motivos de rendimiento, las regiones desfasadas solo se registran en el nivel cero de una textura. Las regiones desfasadas se registran automáticamente cuando se llama a LockBox sin D3DLOCK_NO_DIRTY_UPDATE o D3DLOCK_READONLY. Para obtener más información, vea UpdateTexture.

Requisitos

Plataforma de destino	Windows
Encabezado	d3d9helper.h (incluya D3D9.h)
Library	D3D9.lib

Consulte también

IDirect3DVolumeTexture9

UnlockBox