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

  • Статья

Блокирует поле на ресурсе тома.

Синтаксис

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

Параметры

[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.

Комментарии

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

Требования

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

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

IDirect3DVolume9

IDirect3DVolume9::UnlockBox