Funzione D3DXCreateTexture

Crea una trama vuota, regolando i parametri chiamanti in base alle esigenze.

Sintassi

HRESULT D3DXCreateTexture(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  UINT               Width,
  _In_  UINT               Height,
  _In_  UINT               MipLevels,
  _In_  DWORD              Usage,
  _In_  D3DFORMAT          Format,
  _In_  D3DPOOL            Pool,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Parametri

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntatore a un'interfaccia IDirect3DDevice9 che rappresenta il dispositivo da associare alla trama.

Larghezza [in]

Tipo: UINT

Larghezza in pixel. Se questo valore è 0, viene utilizzato un valore pari a 1. Vedere la sezione Osservazioni.

Altezza [in]

Tipo: UINT

Altezza in pixel. Se questo valore è 0, viene utilizzato un valore pari a 1. Vedere la sezione Osservazioni.

MipLevels [in]

Tipo: UINT

Numero di livelli mip richiesti. Se questo valore è zero o D3DX_DEFAULT, viene creata una catena mipmap completa.

Utilizzo [in]

Tipo: DWORD

0, D3DUSAGE_RENDERTARGET o D3DUSAGE_DYNAMIC. L'impostazione di questo flag su D3DUSAGE_RENDERTARGET indica che la superficie deve essere usata come destinazione di rendering chiamando il metodo SetRenderTarget . Se viene specificato D3DUSAGE_RENDERTARGET o D3DUSAGE_DYNAMIC , l'applicazione deve verificare che il dispositivo supporti questa operazione chiamando CheckDeviceFormat. Per altre informazioni sull'uso di trame dinamiche, vedere Uso di trame dinamiche.

Formato [in]

Tipo: D3DFORMAT

Membro del tipo enumerato D3DFORMAT , che descrive il formato pixel richiesto per la trama. La trama restituita può essere di un formato diverso da quello specificato, se il dispositivo non supporta il formato richiesto. Le applicazioni devono controllare il formato della trama restituita per verificare se corrisponde al formato richiesto.

Pool [in]

Tipo: D3DPOOL

Membro del tipo enumerato D3DPOOL , che descrive la classe di memoria in cui deve essere posizionata la trama.

ppTexture [out]

Tipo: LPDIRECT3DTEXTURE9*

Indirizzo di un puntatore a un'interfaccia IDirect3DTexture9 che rappresenta l'oggetto trama creato.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.

Commenti

Internamente, D3DXCreateTexture usa D3DXCheckTextureRequirements per modificare i parametri chiamanti. Di conseguenza, le chiamate a D3DXCreateTexture avranno spesso esito positivo in cui le chiamate a CreateTexture avranno esito negativo.

Se la proprietà Height e Width sono impostate su D3DX_DEFAULT, per entrambi i parametri viene usato un valore pari a 256. Se Height o Width è impostato su D3DX_DEFAULT E l'altro parametro è impostato su un valore numerico, la trama sarà quadrata con l'altezza e la larghezza uguali al valore numerico.

Requisiti

Requisito	Valore
Intestazione	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

Funzioni trama in D3DX 9