ID2D1DrawInfo::SetPixelShader-Methode (d2d1effectauthor.h)

Legen Sie die Shaderanweisungen für diese Transformation fest.

Syntax

HRESULT SetPixelShader(
  [in] REFGUID            shaderId,
       D2D1_PIXEL_OPTIONS pixelOptions
);

Parameter

[in] shaderId

Typ: REFGUID

Die Ressourcen-ID für den Shader.

pixelOptions

Typ: D2D1_PIXEL_OPTIONS

Zusätzliche Informationen, die dem Renderer zur Verfügung gestellt werden, um die Vorgänge anzugeben, die der Pixelshader ausführt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Wenn dieser Aufruf fehlschlägt, wird die entsprechende ID2D1Effect-instance in einen Fehlerzustand versetzt und führt zu Zeichnen fehl. Dadurch wird der Kontext in einen Fehlerzustand versetzt, der über den ID2D1DeviceContext::EndDraw-Aufruf abgerufen werden kann.

Die Angabe von pixelOptions außer D2D1_PIXEL_OPTIONS_NONE kann es dem Renderer ermöglichen, bestimmte Optimierungen durchzuführen, z. B. das Kombinieren verschiedener Teile des Effektdiagramms. Wenn diese Informationen den Shader nicht genau beschreiben, können unbestimmte Renderingartefakte auftreten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1effectauthor.h
Bibliothek	D2d1.lib

Weitere Informationen

ID2D1DrawInfo