Função D3DXCreateTextureFromFileInMemory

Cria uma textura de um arquivo na memória.

Sintaxe

HRESULT D3DXCreateTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  LPCVOID            pSrcData,
  _In_  UINT               SrcDataSize,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Parâmetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Ponteiro para uma interface IDirect3DDevice9 que representa o dispositivo a ser associado à textura.

pSrcData [in]

Tipo: LPCVOID

Ponteiro para o arquivo na memória do qual criar a textura.

SrcDataSize [in]

Tipo: UINT

Tamanho em bytes do arquivo na memória.

ppTexture [out]

Tipo: LPDIRECT3DTEXTURE9*

Endereço de um ponteiro para uma interface IDirect3DTexture9 que representa o objeto de textura criado.

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 um dos seguintes: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.

Comentários

A função é equivalente a D3DXCreateTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppTexture).

Essa função dá suporte aos seguintes formatos de arquivo: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm e .tga. Confira D3DXIMAGE_FILEFORMAT.

Observe que um recurso criado com essa função quando chamado de um objeto IDirect3DDevice9 será colocado na classe de memória indicada por D3DPOOL_MANAGED. Quando esse método é chamado de um objeto IDirect3DDevice9Ex, o recurso será colocado na classe de memória indicada por D3DPOOL_DEFAULT.

A filtragem é aplicada automaticamente a uma textura criada usando esse método. A filtragem é equivalente a D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER em D3DX_FILTER.

Requisitos

Requisito	Valor
parâmetro	D3dx9tex.h
Biblioteca	D3dx9.lib

Confira também

D3DXCreateTextureFromFileInMemoryEx

Funções de textura no D3DX 9