D3DXCheckCubeTextureRequirements fonction)

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 [ dans]

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 de mipmap demandés, ou null. Retourne le nombre corrigé de niveaux de mipmap.

Utilisation [ dans]

Type : DWORD

0 ou D3DUSAGE _ RENDERTARGET. L’affectation de la valeur D3DUSAGE RENDERTARGET à cet indicateur _ indique que la surface doit être utilisée comme cible de rendu. La ressource peut ensuite être transmise au paramètre pNewRenderTarget de la méthode SetRenderTarget . Si D3DUSAGE _ RENDERTARGET est spécifié, l’application doit vérifier 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 [ dans]

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 est réussie, 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 dans le fait 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.

Configuration requise

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

Voir aussi

Fonctions de texture dans D3DX 9