Функция D3DX11CreateTextureFromFile

  • Статья

Примечание

Библиотека служебных программ D3DX (D3DX 9, D3DX 10 и D3DX 11) устарела для Windows 8 и не поддерживается для приложений Магазина Windows.

Примечание

Вместо этой функции рекомендуется использовать следующие:

  • Библиотека DirectXTK (среда выполнения), CreateXXXTextureFromFile (где XXX — DDS или WIC)
  • Библиотека (средства) DirectXTex, LoadFromXXXFile (где XXX — WIC, DDS или TGA; WIC не поддерживает DDS и TGA; D3DX 9 поддерживает TGA в качестве общего формата источника рисунков для игр), а затем CreateTexture

Создайте ресурс текстуры из файла.

Синтаксис

HRESULT D3DX11CreateTextureFromFile(
  _In_  ID3D11Device           *pDevice,
  _In_  LPCTSTR                pSrcFile,
  _In_  D3DX11_IMAGE_LOAD_INFO *pLoadInfo,
  _In_  ID3DX11ThreadPump      *pPump,
  _Out_ ID3D11Resource         **ppTexture,
  _Out_ HRESULT                *pHResult
);

Параметры

pDevice [in]

Тип: ID3D11Device*

Указатель на устройство (см. ID3D11Device), которое будет использовать ресурс.

pSrcFile [in]

Тип: LPCTSTR

Имя файла, содержащего ресурс. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае тип данных разрешается в LPCSTR.

pLoadInfo [in]

Тип: D3DX11_IMAGE_LOAD_INFO*

Необязательный элемент. Определяет характеристики текстуры (см . D3DX11_IMAGE_LOAD_INFO) при создании обработчика данных; Присвойте этому параметру значение NULL , чтобы считывать характеристики текстуры при загрузке текстуры.

pPump [in]

Тип: ID3DX11ThreadPump*

Указатель на интерфейс потока (см. ID3DX11ThreadPump Interface). Если задано значение NULL , эта функция будет работать синхронно и не будет возвращать, пока не будет завершена.

ppTexture [out]

Тип: ID3D11Resource**

Адрес указателя на ресурс текстуры (см. ID3D11Resource).

pHResult [out]

Тип: HRESULT*

Указатель на возвращаемое значение. Может иметь значение NULL. Если pPump не равно NULL, то pHResult должен быть допустимым расположением памяти до завершения асинхронного выполнения.

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

Тип: HRESULT

Возвращаемое значение является одним из значений, перечисленных в коде возврата Direct3D 11.

Требования

Требование Значение
Заголовок
D3DX11.h
Библиотека
D3DX11.lib

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

Функции D3DX