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 |