Метод ID3D10Device::CreateTexture3D (d3d10.h)

Статья
08/22/2023

Создайте одну трехмерную текстуру (см. 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

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

ИНТЕРФЕЙС ID3D10Device

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