ID2D1Device1::SetRenderingPriority-Methode (d2d1_2.h)

  • Artikel

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

Typ: D2D1_RENDERING_PRIORITY

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

Weitere Informationen

ID2D1Device1