PFND3DDDI_SETMATERIAL Rückruffunktion (d3dumddi.h)
Die SetMaterial--Funktion legt die Materialeigenschaften fest, die geräte auf dem System zum Erstellen des erforderlichen Effekts während des Renderings verwenden.
Syntax
PFND3DDDI_SETMATERIAL Pfnd3dddiSetmaterial;
HRESULT Pfnd3dddiSetmaterial(
HANDLE hDevice,
const D3DDDIARG_SETMATERIAL *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData- [in]
Ein Zeiger auf eine D3DDDIARG_SETMATERIAL Struktur, die die materialeigenschaften beschreibt, die zum Rendern verwendet werden.
Rückgabewert
SetMaterial gibt S_OK oder ein entsprechendes Fehlerergebnis zurück, wenn die Materialeigenschaften nicht erfolgreich festgelegt wurden.
Bemerkungen
Materialeigenschaften enthalten die diffuse Spiegelung, Umgebungsreflektion, Lichtemissionen und glanzförmige Hervorhebungsmerkmale eines Materials. Die Microsoft Direct3D-Laufzeit verwendet die D3DDDIARG_SETMATERIAL Struktur, um alle Materialeigenschafteninformationen an den Anzeigetreiber für den Benutzermodus zu übergeben. Materialeigenschaften wirken sich auf die Farben aus, die von der Direct3D-Laufzeit zum Rastern von Polygonen verwendet werden, die das Material verwenden. Mit Ausnahme der Glanzeigenschaft wird jede der Eigenschaften als RGBA-Farbe beschrieben, die angibt, wie viel der roten, grünen und blauen Teile eines bestimmten Lichttyps, den es widerspiegelt, und einen Alphamischungsfaktor (die Alphakomponente der RGBA-Farbe). Die Glanzeigenschaft des Materials wird in zwei Teilen beschrieben: Farbe und Leistung. Weitere Informationen zu Materialeigenschaften finden Sie in der Microsoft Windows SDK-Dokumentation.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |