Метод IDirect3DCubeTexture9::LockRect (d3d9.h)

Статья
08/23/2023

Блокирует прямоугольник в ресурсе текстуры куба.

Синтаксис

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

Параметры

[in] FaceType

Тип: D3DCUBEMAP_FACES

Член D3DCUBEMAP_FACES перечислимого типа, идентифицируя грань карты куба.

[in] Level

Тип: UINT

Задает уровень текстуры куба mipmapped.

[out] pLockedRect

Тип: D3DLOCKED_RECT*

Указатель на структуру D3DLOCKED_RECT , описывающую область для блокировки.

[in] pRect

Тип: const RECT*

Указатель на прямоугольник для блокировки. Определяется указателем на структуру RECT . Если указать значение NULL для этого параметра, область грязное будет охватывать всю текстуру куба.

[in] Flags

Тип: DWORD

Сочетание нулевых или более флагов блокировки, описывающих тип выполняемой блокировки. Для этого метода допустимыми флагами являются:

D3DLOCK_DISCARD
D3DLOCK_NO_DIRTY_UPDATE
D3DLOCK_NOSYSLOCK
D3DLOCK_READONLY

При использовании D3DLOCK_DISCARD нельзя указывать подэкт. Описание флагов см. в разделе D3DLOCK.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. D3DERR_INVALIDCALL возвращается, если один или несколько аргументов недопустимы.

Из соображений производительности грязное области записываются только для нулевого уровня текстуры. Грязные области автоматически записываются при вызове IDirect3DCubeTexture9::LockRect без D3DLOCK_NO_DIRTY_UPDATE или D3DLOCK_READONLY. Дополнительные сведения см. в разделе IDirect3DDevice9::UpdateTexture .

Текстуры куба, созданные с помощью D3DPOOL_DEFAULT, не блокируются. Текстуры куба, созданные в видеопамяти, блокируются при создании с помощью USAGE_DYNAMIC.

Единственным блокируемым форматом текстуры трафарета глубины является D3DFMT_D16_LOCKABLE.