Метод IDirect3DVolumeTexture9::LockBox (d3d9helper.h)

Статья
08/23/2023

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

Синтаксис

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

Параметры

[in] Level

Тип: UINT

Указывает уровень ресурса текстуры тома для блокировки.

[out] pLockedVolume

Тип: D3DLOCKED_BOX*

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

[in] pBox

Тип: const D3DBOX*

Указатель на том для блокировки. Этот параметр задается указателем на структуру D3DBOX . Если указать значение NULL для этого параметра, весь уровень тома блокируется.

[in] Flags

Тип: DWORD

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

D3DLOCK_DISCARD
D3DLOCK_NO_DIRTY_UPDATE
D3DLOCK_NOSYSLOCK
D3DLOCK_READONLY

Описание флагов см. в разделе D3DLOCK.

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

Тип: HRESULT

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

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

Требования


Целевая платформа	Windows
Header	d3d9helper.h (включая D3D9.h)
Библиотека	D3D9.lib

См. также раздел

IDirect3DVolumeTexture9

UnlockBox

Share via