PFND3DDDI_SETMATERIAL fonction de rappel (d3dumddi.h)
La fonction SetMaterial définit les propriétés matérielles que les appareils du système utilisent pour créer l’effet requis pendant le rendu.
Syntaxe
PFND3DDDI_SETMATERIAL Pfnd3dddiSetmaterial;
HRESULT Pfnd3dddiSetmaterial(
HANDLE hDevice,
const D3DDDIARG_SETMATERIAL *unnamedParam2
)
{...}
Paramètres
hDevice
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in]
Pointeur vers une structure D3DDDIARG_SETMATERIAL qui décrit les propriétés de matériau utilisées pour le rendu.
Valeur de retour
SetMaterial retourne S_OK ou un résultat d’erreur approprié si les propriétés matérielles ne sont pas correctement définies.
Remarques
Les propriétés matérielles détaillent la réflexion diffuse d’un matériau, la réflexion ambiante, l’émission de lumière et les caractéristiques de mise en surbrillance spéculaire. Le runtime Microsoft Direct3D utilise la structure D3DDDIARG_SETMATERIAL pour transmettre toutes les informations de propriété matérielles au pilote d’affichage en mode utilisateur. Les propriétés de matériau affectent les couleurs utilisées par le runtime Direct3D pour rastériser les polygones qui utilisent le matériau. À l’exception de la propriété spéculaire, chacune des propriétés est décrite comme une couleur RVBA qui représente la quantité de parties rouge, verte et bleue d’un type donné de lumière qu’elle reflète et un facteur de fusion alpha (composant alpha de la couleur RVBA). La propriété spéculaire du matériau est décrite en deux parties : la couleur et la puissance. Pour plus d’informations sur les propriétés matérielles, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Windows.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |