PFND3DDDI_SETMATERIAL fonction de rappel (d3dumddi.h)

La fonction SetMaterial définit les propriétés de matériau 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 matérielles utilisées pour le rendu.

Valeur retournée

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, la réflexion ambiante, l’émission de lumière et les caractéristiques de mise en surbrillance spéculaire d’un matériau. Le runtime Microsoft Direct3D utilise la structure D3DDDIARG_SETMATERIAL pour transmettre toutes les informations de propriété matérielle 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é des parties rouges, vertes et bleues d’un type de lumière donné 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 : couleur et puissance. Pour plus d’informations sur les propriétés des matériaux, consultez la documentation Microsoft Windows SDK.

Configuration requise

Voir aussi

D3DDDIARG_SETMATERIAL

D3DDDI_DEVICEFUNCS