Funzione D3DXCheckTextureRequirements

Controlla i parametri di creazione della trama.

Sintassi

HRESULT D3DXCheckTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pWidth,
  _Inout_ UINT              *pHeight,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

Parametri

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

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

pWidth [in, out]

Tipo: UINT*

Puntatore alla larghezza richiesta in pixel o NULL. Restituisce le dimensioni corrette.

pHeight [in, out]

Tipo: UINT*

Puntatore all'altezza richiesta in pixel o NULL. Restituisce le dimensioni corrette.

pNumMipLevels [in, out]

Tipo: UINT*

Puntatore al numero di livelli mipmap richiesti o NULL. Restituisce il numero corretto di livelli mipmap.

Utilizzo [in]

Tipo: DWORD

0 o D3DUSAGE_RENDERTARGET. L'impostazione di questo flag su D3DUSAGE_RENDERTARGET indica che la superficie deve essere usata come destinazione di rendering. La risorsa può quindi essere passata al parametro pNewRenderTarget del metodo SetRenderTarget . Se viene specificato D3DUSAGE_RENDERTARGET , l'applicazione deve verificare che il dispositivo supporti questa operazione chiamando CheckDeviceFormat.

pFormat [in, out]

Tipo: D3DFORMAT*

Puntatore a un membro del tipo enumerato D3DFORMAT . Specifica il formato pixel desiderato o NULL. Restituisce il formato corretto.

Pool [in]

Tipo: D3DPOOL

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

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.

Commenti

Se i parametri di questa funzione non sono validi, questa funzione restituisce parametri corretti.

Questa funzione usa l'euristica seguente quando si confrontano i requisiti richiesti con i formati disponibili:

• Non scegliere un formato con meno canali.
• Evitare formati FOURCC e a 24 bit, a meno che non vengano richiesti in modo esplicito.
• Provare a non aggiungere nuovi canali.
• Provare a non modificare il numero di bit per canale.
• Provare a evitare la conversione tra tipi di formati. Ad esempio, evitare di convertire un formato ARGB in un formato di profondità.

Requisiti

Vedi anche

Funzioni trama in D3DX 9