Функция 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 в формат глубины.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел