ID2D1Device1::SetRenderingPriority-Methode (d2d1_2.h)
Legt die Priorität von Direct2D-Renderingvorgängen fest, die für jeden Gerätekontext ausgeführt werden, der dem Gerät zugeordnet ist.
Syntax
void SetRenderingPriority(
D2D1_RENDERING_PRIORITY renderingPriority
);
Parameter
renderingPriority
Die gewünschte Renderingpriorität für das Gerät und die zugehörigen Kontexte.
Rückgabewert
Typ: HRESULT
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | Kein Fehler ist aufgetreten. |
| E_OUTOFMEMORY | Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen. |
| E_INVALIDARG | Ein ungültiger Parameter wurde an die zurückgebende Funktion übergeben. |
Hinweise
Das Aufrufen dieser Methode wirkt sich auf die Renderingpriorität aller Gerätekontexte aus, die dem Gerät zugeordnet sind. Diese Methode kann jederzeit aufgerufen werden, wird aber erst am Anfang des nächsten Frames wirksam. Die empfohlene Verwendung besteht darin, diese Methode außerhalb der BeginDraw - und EndDraw-Blöcke aufzurufen. Durch häufiges Durchlaufen dieser Eigenschaft innerhalb von Ziehblöcken werden die Vorteile der angewendeten Drosselung effektiv reduziert.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8.1 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d2d1_2.h |
| Bibliothek | D2d1.lib |
| DLL | D2d1.dll |