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

Bloquea un cuadro en un recurso de volumen.

Sintaxis

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

Parámetros

[out] pLockedVolume

Tipo: D3DLOCKED_BOX*

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

[in] pBox

Tipo: const D3DBOX*

Puntero a un cuadro que se va a bloquear. Especificado por un puntero a una estructura D3DBOX . Si se especifica NULL para este parámetro, se bloquea todo el 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 IDirect3DVolume9::LockBox sin D3DLOCK_NO_DIRTY_UPDATE ni D3DLOCK_READONLY. Consulte IDirect3DDevice9::UpdateTexture para obtener más información.

Requisitos

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

Consulte también

IDirect3DVolume9

IDirect3DVolume9::UnlockBox