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