Compartilhar via


Função D3DX11CreateTextureFromFile

Observação

A biblioteca de utilitários D3DX (D3DX 9, D3DX 10 e D3DX 11) foi preterida para Windows 8 e não tem suporte para aplicativos da Windows Store.

Observação

Em vez de usar essa função, recomendamos que você use estes:

  • Biblioteca DirectXTK (runtime), CreateXXXTextureFromFile (em que XXX é DDS ou WIC)
  • Biblioteca DirectXTex (ferramentas), LoadFromXXXFile (em que XXX é WIC, DDS ou TGA; O WIC não dá suporte a DDS e TGA; O D3DX 9 dá suporte à TGA como um formato de fonte de arte comum para jogos) e, em seguida, CreateTexture

Crie um recurso de textura de um arquivo.

Sintaxe

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

Parâmetros

pDevice [in]

Tipo: ID3D11Device*

Um ponteiro para o dispositivo (consulte ID3D11Device) que usará o recurso.

pSrcFile [in]

Tipo: LPCTSTR

O nome do arquivo que contém o recurso. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados será resolvido para LPCSTR.

pLoadInfo [in]

Tipo: D3DX11_IMAGE_LOAD_INFO*

Opcional. Identifica as características de uma textura (consulte D3DX11_IMAGE_LOAD_INFO) quando o processador de dados é criado; defina isso como NULL para ler as características de uma textura quando a textura for carregada.

pPump [in]

Tipo: ID3DX11ThreadPump*

Um ponteiro para uma interface de bomba de thread (consulte Interface ID3DX11ThreadPump). Se NULL for especificado, essa função se comportará de forma síncrona e não retornará até que seja concluída.

ppTexture [out]

Tipo: ID3D11Resource**

O endereço de um ponteiro para o recurso de textura (consulte ID3D11Resource).

pHResult [out]

Tipo: HRESULT*

Um ponteiro para o valor retornado. Pode ser NULL. Se pPump não for NULL, pHResult deverá ser um local de memória válido até que a execução assíncrona seja concluída.

Valor retornado

Tipo: HRESULT

O valor retornado é um dos valores listados em Códigos de Retorno do Direct3D 11.

Requisitos

Requisito Valor
parâmetro
D3DX11.h
Biblioteca
D3DX11.lib

Confira também

Funções D3DX