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
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche