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

Статья
08/22/2023

Создайте массив двухd-текстур (см. texture2D).

Синтаксис

HRESULT CreateTexture2D(
  [in]  const D3D10_TEXTURE2D_DESC   *pDesc,
  [in]  const D3D10_SUBRESOURCE_DATA *pInitialData,
  [out] ID3D10Texture2D              **ppTexture2D
);

Параметры

[in] pDesc

Тип: const D3D10_TEXTURE2D_DESC*

Указатель на описание двухмерной текстуры (см . D3D10_TEXTURE2D_DESC). Чтобы создать нетипизированный ресурс, который можно интерпретировать во время выполнения в разных совместимых форматах, укажите нетипизированный формат в описании текстуры. Чтобы автоматически создавать уровни MIP-карты, задайте для количества уровней MIP-карты значение 0.

[in] pInitialData

Тип: const D3D10_SUBRESOURCE_DATA*

Указатель на массив описаний подресурса (см . D3D10_SUBRESOURCE_DATA); по одному для каждого подресурса (упорядочен по индексу массива текстуры, затем по уровню MIP). Приложения не могут указывать значение NULL для pInitialData при создании ресурсов IMMUTABLE (см . D3D10_USAGE). Если ресурс имеет несколько выборок, pInitialData должен иметь значение NULL , так как ресурсы с несколькими выборками нельзя инициализировать с данными при их создании.

[out] ppTexture2D

Тип: ID3D10Texture2D**

Адрес указателя на созданную текстуру (см . интерфейс ID3D10Texture2D). Присвойте этому параметру значение NULL , чтобы проверить другие входные параметры (метод вернет S_FALSE, если другие входные параметры пройдут проверку).

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, код возврата S_OK. Коды ошибок сбоя см. в разделе Коды возврата Direct3D 10 .

CreateTexture2D создает ресурс двухd-текстуры, содержащий массив 1D-текстур. Количество текстур указывается в описании текстуры. Все текстуры в ресурсе должны иметь одинаковый формат, размер и количество уровней MIP-карты.

Все ресурсы состоят из одного или нескольких подресурсов. Для загрузки данных в текстуру приложения могут изначально предоставлять данные в составе D3D10_SUBRESOURCE_DATA структуры, на которую указывает pInitialData, или использовать одну из функций texturing , предоставляемых пакетом SDK.

Требования

Требование	Значение
Целевая платформа	Windows
Header	d3d10.h
Библиотека	D3D10.lib

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

ИНТЕРФЕЙС ID3D10Device