D3DXCheckTextureRequirements fonction)
Vérifie les paramètres de création de texture.
Syntaxe
HRESULT D3DXCheckTextureRequirements(
_In_ LPDIRECT3DDEVICE9 pDevice,
_Inout_ UINT *pWidth,
_Inout_ UINT *pHeight,
_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.
-
pWidth [ in, out]
-
Type : uint*
Pointeur vers la largeur demandée en pixels, ou null. Retourne la taille corrigée.
-
pHeight [ in, out]
-
Type : uint*
Pointeur vers la hauteur demandée 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 _ INVALIDCALL, D3DERR _ NOTAVAILABLE.
Remarques
Si les paramètres de cette fonction ne sont pas valides, cette fonction retourne les paramètres corrigés.
Cette fonction utilise l’heuristique suivante lors de la comparaison des exigences demandées par rapport aux formats disponibles :
- Ne choisissez pas un format comportant moins de canaux.
- Évitez les formats FourCC et 24 bits sauf demande explicite.
- Essayez de ne pas ajouter de nouveaux canaux.
- Essayez de ne pas modifier le nombre de bits par canal.
- Essayez d’éviter la conversion entre les types de formats. Par exemple, évitez de convertir un format ARVB en un format de profondeur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|