Função D3DX11GetImageInfoFromFile

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 a biblioteca DirectXTex , GetMetadataFromXXXFile (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 um determinado arquivo de imagem.

Sintaxe

HRESULT D3DX11GetImageInfoFromFile(
  _In_  LPCTSTR           pSrcFile,
  _In_  ID3DX11ThreadPump *pPump,
  _In_  D3DX11_IMAGE_INFO *pSrcInfo,
  _Out_ HRESULT           *pHResult
);

Parâmetros

pSrcFile [in]

Tipo: LPCTSTR

Nome do arquivo da imagem sobre o qual recuperar informações. Se UNICODE ou _UNICODE forem definidos, esse tipo de parâmetro será LPCWSTR; caso contrário, o tipo será LPCSTR.

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 um D3DX11_IMAGE_INFO a ser preenchido 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

Essa função dá suporte a cadeias de caracteres Unicode e ANSI.

Requisitos

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

Confira também

Funções D3DX