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 |
|
| Biblioteca |
|