Fonction D3DXCheckCubeTextureRequirements

Article
06/13/2023

Vérifie les paramètres de création de texture de cube.

Syntaxe

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

Paramètres

pDevice [in]

Type : LPDIRECT3DDEVICE9

Pointeur vers une interface IDirect3DDevice9 , représentant l’appareil à associer à la texture du cube.

pSize [in, out]

Type : UINT*

Pointeur vers la largeur et la hauteur demandées en pixels, ou NULL. Retourne la taille corrigée.

pNumMipLevels [in, out]

Type : UINT*

Pointeur vers le nombre de niveaux mipmap demandés, ou NULL. Retourne le nombre corrigé de niveaux mipmap.

Utilisation [in]

Type : DWORD

0 ou D3DUSAGE_RENDERTARGET. Le fait de définir cet indicateur sur D3DUSAGE_RENDERTARGET indique que la surface doit être utilisée comme cible de rendu. La ressource peut ensuite être passée au paramètre pNewRenderTarget de la méthode SetRenderTarget . Si D3DUSAGE_RENDERTARGET est spécifié, l’application doit case activée que l’appareil prend en charge cette opération en appelant CheckDeviceFormat.

pFormat [in, out]

Type : D3DFORMAT*

Pointeur vers un membre du type énuméré D3DFORMAT . Spécifie le format de pixel souhaité, ou NULL. Retourne le format corrigé.

Pool [in]

Type : D3DPOOL

Membre du type énuméré D3DPOOL , décrivant la classe de mémoire dans laquelle la texture doit être placée.

Valeur retournée

Type : HRESULT

Si la fonction réussit, la valeur de retour est D3D_OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR_NOTAVAILABLE, D3DERR_INVALIDCALL.

Notes

Si les paramètres de cette fonction ne sont pas valides, cette fonction retourne les paramètres corrigés.

Les textures de cube diffèrent des autres surfaces en ce qu’il s’agit de collections de surfaces. Pour appeler SetRenderTarget avec une texture de cube, vous devez sélectionner un visage individuel à l’aide de GetCubeMapSurface et passer la surface résultante à SetRenderTarget.

Spécifications

Condition requise	Valeur
En-tête	D3dx9tex.h
Bibliothèque	D3dx9.lib

Voir aussi

Fonctions de texture dans D3DX 9

Partager via