Поделиться через

Функция D3DXCreateVolumeTexture

  • Статья

Создает пустую текстуру тома, изменяя вызывающие параметры по мере необходимости.

Синтаксис

HRESULT D3DXCreateVolumeTexture(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  UINT                     Width,
  _In_  UINT                     Height,
  _In_  UINT                     Depth,
  _In_  UINT                     MipLevels,
  _In_  DWORD                    Usage,
  _In_  D3DFORMAT                Format,
  _In_  D3DPOOL                  Pool,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

Параметры

pDevice [in]

Тип: LPDIRECT3DDEVICE9

Указатель на интерфейс IDirect3DDevice9 , представляющий устройство, связанное с текстурой тома.

Ширина [in]

Тип: UINT

Ширина в пикселях. Это значение должно быть ненулевым. Максимальное измерение, которое поддерживает драйвер (для ширины, высоты и глубины), можно найти в maxVolumeExtent в D3DCAPS9.

Высота [in]

Тип: UINT

Высота в пикселях. Это значение должно быть ненулевым. Максимальное измерение, которое поддерживает драйвер (для ширины, высоты и глубины), можно найти в maxVolumeExtent в D3DCAPS9.

Глубина [в]

Тип: UINT

Глубина в пикселях. Это значение должно быть ненулевым. Максимальное измерение, которое поддерживает драйвер (для ширины, высоты и глубины), можно найти в maxVolumeExtent в D3DCAPS9.

MipLevels [in]

Тип: UINT

Количество запрошенных уровней MIP. Если это значение равно нулю или D3DX_DEFAULT, создается полная цепочка MIP-карты.

Использование [в]

Тип: DWORD

0 или D3DUSAGE_DYNAMIC. Дополнительные сведения об использовании динамических текстур см. в разделе Использование динамических текстур.

Формат [in]

Тип: D3DFORMAT

Член перечисленного типа D3DFORMAT , описывающий запрошенный формат пикселей для текстуры тома. Возвращаемая текстура тома может иметь формат, отличный от формата, заданного параметром Format. Приложения должны проверка формат возвращаемой текстуры тома.

Пул [в]

Тип: D3DPOOL

Член перечисленного типа D3DPOOL , описывающий класс памяти, в который должна быть помещена текстура тома.

ppVolumeTexture [out]

Тип: LPDIRECT3DVOLUMETEXTURE9*

Адрес указателя на интерфейс IDirect3DVolumeTexture9 , представляющий созданный объект текстуры тома.

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

Тип: HRESULT

Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается сбоем, возвращается одно из следующих значений: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL E_OUTOFMEMORY .

Комментарии

Внутри D3DXCreateVolumeTexture использует D3DXCheckVolumeTextureRequirements для настройки параметров вызова. Поэтому вызовы D3DXCreateVolumeTexture часто выполняются успешно, если вызовы CreateVolumeTexture завершаются ошибкой .

Требования

Требование Значение
Заголовок
D3dx9tex.h
Библиотека
D3dx9.lib

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

Функции текстур в D3DX 9