IDXGIResource::GetEvictionPriority-Methode (dxgi.h)

Rufen Sie die Räumungspriorität ab.

Syntax

HRESULT GetEvictionPriority(
  [out] UINT *pEvictionPriority
);

Parameter

[out] pEvictionPriority

Typ: UINT*

Ein Zeiger auf die Entfernungspriorität, der bestimmt, wann eine Ressource aus dem Arbeitsspeicher entfernt werden kann.

Die folgenden definierten Werte sind möglich.

Wert Bedeutung
DXGI_RESOURCE_PRIORITY_MINIMUM (0x28000000)
Die Ressource wird nicht verwendet und kann entfernt werden, sobald eine andere Ressource den von der Ressource belegten Arbeitsspeicher benötigt.
DXGI_RESOURCE_PRIORITY_LOW (0x50000000)
Die Räumungspriorität der Ressource ist niedrig. Die Platzierung der Ressource ist nicht kritisch, und es wird nur minimale Arbeit ausgeführt, um einen Standort für die Ressource zu finden. Wenn eine GPU beispielsweise mit einem Vertexpuffer aus lokalem oder nicht lokalem Speicher mit geringem Leistungsunterschied rendern kann, hat dieser Vertexpuffer eine niedrige Priorität. Andere wichtigere Ressourcen (z. B. ein Renderziel oder eine Textur) können dann den schnelleren Arbeitsspeicher belegen.
DXGI_RESOURCE_PRIORITY_NORMAL (0x78000000)
Die Räumungspriorität der Ressource ist normal. Die Platzierung der Ressource ist wichtig, aber nicht entscheidend für die Leistung. Die Ressource wird an ihrem bevorzugten Speicherort anstelle einer Ressource mit niedriger Priorität platziert.
DXGI_RESOURCE_PRIORITY_HIGH (0xa0000000)
Die Räumungspriorität der Ressource ist hoch. Die Ressource wird an ihrem bevorzugten Speicherort anstelle einer Ressource mit niedriger oder normaler Priorität platziert.
DXGI_RESOURCE_PRIORITY_MAXIMUM (0xc8000000)
Die Ressource wird nur dann aus dem Arbeitsspeicher entfernt, wenn es keine andere Möglichkeit gibt, die Arbeitsspeicheranforderung aufzulösen.

Rückgabewert

Typ: HRESULT

Gibt eine der folgenden DXGI_ERROR zurück.

Hinweise

Die Entfernungspriorität ist eine Speicherverwaltungsvariable, die von DXGI verwendet wird, um zu bestimmen, wie der übermäßig belegte Arbeitsspeicher verwaltet werden soll.

Andere Prioritätsebenen als die definierten Werte werden ggf. verwendet. Beispielsweise gibt eine Ressource mit der Prioritätsebene 0x78000001 an, dass die Ressource leicht über dem Normalwert liegt.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile dxgi.h
Bibliothek DXGI.lib

Weitere Informationen

IDXGIResource