PFND3DDDI_SETMATERIAL Rückruffunktion (d3dumddi.h)

  • Artikel

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)

Weitere Informationen

D3DDDIARG_SETMATERIAL

D3DDDI_DEVICEFUNCS