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

Функция D3DXCheckTextureRequirements

  • Статья

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

Синтаксис

HRESULT D3DXCheckTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pWidth,
  _Inout_ UINT              *pHeight,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

Параметры

pDevice [in]

Тип: LPDIRECT3DDEVICE9

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

pWidth [вход, выход]

Тип: UINT*

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

pHeight [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_INVALIDCALL D3DERR_NOTAVAILABLE.

Комментарии

Если параметры этой функции недопустимы, эта функция возвращает исправленные параметры.

Эта функция использует следующие эвристические методы при сравнении запрошенных требований с доступными форматами:

  • Не выбирайте формат с меньшим количеством каналов.
  • Избегайте 24-разрядных форматов FOURCC и , если они не запрошены явным образом.
  • Старайтесь не добавлять новые каналы.
  • Старайтесь не изменять число битов на канал.
  • Старайтесь избегать преобразования между типами форматов. Например, не следует преобразовывать формат ARGB в формат глубины.

Требования

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

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

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