Функция D3DXCheckCubeTextureRequirements

Статья
06/13/2023

Проверяет параметры создания текстуры куба.

Синтаксис

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

Параметры

pDevice [in]

Тип: LPDIRECT3DDEVICE9

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

pSize [in, out]

Тип: UINT*

Указатель на запрошенную ширину и высоту в пикселях или ЗНАЧЕНИЕ NULL. Возвращает исправленный размер.

pNumMipLevels [in, out]

Тип: UINT*

Указатель на количество запрошенных уровней MIP-карты или NULL. Возвращает исправленное количество уровней MIP-карты.

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

Тип: DWORD

0 или D3DUSAGE_RENDERTARGET. Установка этого флага D3DUSAGE_RENDERTARGET означает, что поверхность будет использоваться в качестве целевого объекта отрисовки. Затем ресурс можно передать в параметр pNewRenderTarget метода SetRenderTarget . Если указан D3DUSAGE_RENDERTARGET, приложение должно проверка, что устройство поддерживает эту операцию, вызвав CheckDeviceFormat.

pFormat [in, out]

Тип: D3DFORMAT*

Указатель на член перечисленного типа D3DFORMAT . Задает требуемый формат пикселей или значение NULL. Возвращает исправленный формат.

Пул [в]

Тип: D3DPOOL

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

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

Тип: HRESULT

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

Текстуры куба отличаются от других поверхностей тем, что они являются коллекциями поверхностей. Чтобы вызвать SetRenderTarget с текстурой куба, необходимо выбрать отдельное лицо с помощью GetCubeMapSurface и передать полученную поверхность в SetRenderTarget.

Требования

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

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

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

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