PFND3DDDI_SETMATERIAL Rückruffunktion (d3dumddi.h)
Die SetMaterial-Funktion legt die Materialeigenschaften fest, die Geräte im System verwenden, um den erforderlichen Effekt während des Renderings zu erzeugen.
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.
Hinweise
Materialeigenschaften beschreiben die diffuse Reflexion, die Umgebungsreflektion, die Lichtemission und die spekulären Hervorhebungseigenschaften eines Materials. Die Microsoft Direct3D-Runtime verwendet die D3DDDIARG_SETMATERIAL-Struktur , um alle Materialeigenschafteninformationen an den Benutzermodusanzeigetreiber zu übergeben. Materialeigenschaften wirken sich auf die Farben aus, die die Direct3D-Runtime zum Rastern von Polygonen verwendet, die das Material verwenden. Mit Ausnahme der spekulären Eigenschaft wird jede der Eigenschaften als RGBA-Farbe beschrieben, die darstellt, wie viel rot, grün und blau eines bestimmten Lichttyps reflektiert wird, und ein Alpha-Blending-Faktor (die Alphakomponente der RGBA-Farbe). Die spekuläre Eigenschaft des Materials wird in zwei Teilen beschrieben: Farbe und Kraft. Weitere Informationen zu Materialeigenschaften finden Sie in der Microsoft Windows SDK-Dokumentation.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |