Função D3DX11CreateTextureFromResource

Artigo
06/13/2023

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 funções de recurso e, em seguida, estas:

Biblioteca DirectXTK (runtime), CreateXXXTextureFromMemory (em que XXX é DDS ou WIC)
Biblioteca DirectXTex (ferramentas), LoadFromXXXMemory (em que XXX é WIC, DDS ou TGA; O WIC não dá suporte a DDS e TGA; D3DX 9 compatível com TGA como um formato de origem de arte comum para jogos) e, em seguida, CreateTexture

Crie uma textura de outro recurso.

Sintaxe

HRESULT D3DX11CreateTextureFromResource(
  _In_  ID3D11Device           *pDevice,
  _In_  HMODULE                hSrcModule,
  _In_  LPCTSTR                pSrcResource,
  _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.

hSrcModule [in]

Tipo: HMODULE

Um identificador para o recurso de origem. O HMODULE pode ser obtido com a Função GetModuleHandle.

pSrcResource [in]

Tipo: LPCTSTR

Uma cadeia de caracteres que contém o nome do recurso de origem. 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

Compartilhar via