Метод ID3D10Device::CreateTexture3D (d3d10.h)
Создайте одну трехмерную текстуру (см. Texture3D).
Синтаксис
HRESULT CreateTexture3D(
[in] const D3D10_TEXTURE3D_DESC *pDesc,
[in] const D3D10_SUBRESOURCE_DATA *pInitialData,
[out] ID3D10Texture3D **ppTexture3D
);
Параметры
[in] pDesc
Тип: const D3D10_TEXTURE3D_DESC*
Указатель на описание трехмерной текстуры (см . D3D10_TEXTURE3D_DESC). Чтобы создать нетипизированный ресурс, который можно интерпретировать во время выполнения в разных совместимых форматах, укажите нетипизированный формат в описании текстуры. Чтобы автоматически создавать уровни MIP-карты, задайте для количества уровней MIP-карты значение 0.
[in] pInitialData
Тип: const D3D10_SUBRESOURCE_DATA*
Указатель на массив описаний подресурса (см . D3D10_SUBRESOURCE_DATA); по одному для каждого подресурса (упорядочен по индексу массива текстуры, затем индексу среза и уровню MIP). Приложения не могут указывать значение NULL для pInitialData при создании ресурсов IMMUTABLE (см . D3D10_USAGE). Если ресурс имеет несколько выборок, pInitialData должен иметь значение NULL , так как ресурсы с несколькими выборками нельзя инициализировать с данными при их создании.
[out] ppTexture3D
Тип: ID3D10Texture3D**
Адрес указателя на созданную текстуру (см . ID3D10Texture3D Interface). Присвойте этому параметру значение NULL , чтобы проверить другие входные параметры (метод вернет S_FALSE, если другие входные параметры пройдут проверку).
Возвращаемое значение
Тип: HRESULT
Если метод выполнен успешно, код возврата S_OK. Коды ошибок сбоя см. в разделе Коды возврата Direct3D 10 .
Комментарии
CreateTexture3D создает ресурс трехмерной текстуры, содержащий массив 1D-текстур. Количество текстур указывается в описании текстуры. Все текстуры в ресурсе должны иметь одинаковый формат, размер и количество уровней MIP-карты.
Все ресурсы состоят из одного или нескольких подресурсов. Для загрузки данных в текстуру приложения могут изначально предоставлять данные в составе D3D10_SUBRESOURCE_DATA структуры, на которую указывает pInitialData, или использовать одну из функций texturing , предоставляемых пакетом SDK.
Требования
| Целевая платформа | Windows |
| Header | d3d10.h |
| Библиотека | D3D10.lib |