Freigeben über


IDirectDrawSurface7::GetPriority-Methode (ddraw.h)

Ruft die Texturverwaltungspriorität für diese Textur ab. Diese Methode ist nur bei verwalteten Texturen erfolgreich.

Syntax

HRESULT GetPriority(
  [out] LPDWORD unnamedParam1
);

Parameter

[out] unnamedParam1

Ein Zeiger auf eine Variable, die die Texturpriorität empfängt, wenn der Aufruf erfolgreich ist.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.

Wenn ein Fehler auftritt, ist der Rückgabewert ein Fehler. Die Methode gibt DDERR_INVALIDOBJECT zurück, wenn der Parameter ungültig ist oder wenn die Textur nicht von Direct3D verwaltet wird.

Hinweise

Prioritäten werden verwendet, um zu bestimmen, wann verwaltete Texturen aus dem Arbeitsspeicher entfernt werden sollen. Eine Textur, der eine niedrige Priorität zugewiesen ist, wird vor einer Textur mit hoher Priorität entfernt. Wenn zwei Texturen dieselbe Priorität haben, wird die zuletzt verwendete Textur im Arbeitsspeicher beibehalten. die andere Textur wird entfernt.

Anwendungen können Prioritäten nur für verwaltete Texturen (oberflächen, die mit dem DDSCAPS2_TEXTUREMANAGE-Flag erstellt wurden) festlegen und abrufen. Wenn Sie GetPriority für eine nicht verwaltete Textur aufrufen, schlägt GetPriority fehl und gibt DDERR_INVALIDOBJECT zurück.

GetPriority wurde mit der IDirectDrawSurface7-Schnittstelle eingeführt.

Anforderungen

   
Zielplattform Windows
Kopfzeile ddraw.h
Bibliothek Ddraw.lib
DLL Ddraw.dll

Weitere Informationen

IDirectDrawSurface7