Função D3DX11GetImageInfoFromResource

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 use a biblioteca DirectXTex (ferramentas), LoadFromXXXMemory (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).

Recupera informações sobre uma determinada imagem em um recurso.

Sintaxe

HRESULT D3DX11GetImageInfoFromResource(
  _In_  HMODULE           hSrcModule,
  _In_  LPCTSTR           pSrcResource,
  _In_  ID3DX11ThreadPump *pPump,
  _In_  D3DX11_IMAGE_INFO *pSrcInfo,
  _Out_ HRESULT           *pHResult
);

Parâmetros

hSrcModule [in]

Tipo: HMODULE

Módulo em que o recurso é carregado. Defina esse parâmetro como NULL para especificar o módulo associado à imagem que o sistema operacional usou para criar o processo atual.

pSrcResource [in]

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres que especifica o nome do arquivo. 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. Consulte Observações.

pPump [in]

Tipo: ID3DX11ThreadPump*

Bomba de thread opcional que pode ser usada para carregar as informações de forma assíncrona. Pode ser NULL. Consulte Interface ID3DX11ThreadPump.

pSrcInfo [in]

Tipo: D3DX11_IMAGE_INFO*

Ponteiro para uma estrutura D3DX11_IMAGE_INFO a ser preenchida com a descrição dos dados no arquivo de origem.

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

Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser o seguinte: D3DERR_INVALIDCALL

Comentários

A configuração do compilador também determina a versão da função. Se Unicode for definido, a chamada de função será resolvida para D3DX11GetImageInfoFromResourceW. Caso contrário, a chamada de função será resolvida para D3DX11GetImageInfoFromResourceA porque as cadeias de caracteres ANSI estão sendo usadas.

Requisitos

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

Confira também

Funções D3DX