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 |
|
| Bibliothèque |
|