Funzione D3DXCheckCubeTextureRequirements

Articolo
06/13/2023

Controlla i parametri di creazione della trama del cubo.

Sintassi

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _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 del cubo.

pSize [in, out]

Tipo: UINT*

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

pNumMipLevels [in, out]

Tipo: UINT*

Puntatore al numero di livelli di mipmap richiesti o NULL. Restituisce il numero corretto di livelli di 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 è D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_NOTAVAILABLE, D3DERR_INVALIDCALL.

Commenti

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

Le trame del cubo differiscono da altre superfici in cui sono raccolte di superfici. Per chiamare SetRenderTarget con una trama del cubo, è necessario selezionare un singolo viso usando GetCubeMapSurface e passare la superficie risultante a SetRenderTarget.

Requisiti

Requisito	Valore
Intestazione	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

Funzioni trama in D3DX 9