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

Artículo
08/23/2023

Bloquea un rectángulo en un recurso de textura de cubo.

Sintaxis

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

Miembro del tipo enumerado D3DCUBEMAP_FACES , identificando una cara de mapa de cubo.

[in] Level

Tipo: UINT

Especifica un nivel de textura de cubo mipmapped.

[out] pLockedRect

Tipo: D3DLOCKED_RECT*

Puntero a una estructura de D3DLOCKED_RECT , que describe la región que se va a bloquear.

[in] pRect

Tipo: const RECT*

Puntero a un rectángulo que se va a bloquear. Especificado por un puntero a una estructura RECT . Al especificar NULL para este parámetro, se expande la región desfasada para cubrir toda la textura del cubo.

[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

Es posible que no especifique un subrecurso al usar D3DLOCK_DISCARD. 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. D3DERR_INVALIDCALL se devuelve si uno o varios de los argumentos no son válidos.

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 IDirect3DCubeTexture9::LockRect sin D3DLOCK_NO_DIRTY_UPDATE ni D3DLOCK_READONLY. Consulte IDirect3DDevice9::UpdateTexture para obtener más información.

Las texturas de cubo creadas con D3DPOOL_DEFAULT no se pueden bloquear. Las texturas de cubo creadas en la memoria de vídeo se pueden bloquear cuando se crean con USAGE_DYNAMIC.

El único formato bloqueable para una textura de galería de símbolos de profundidad es D3DFMT_D16_LOCKABLE.