IDirectDrawSurface7::SetPriority-Methode (ddraw.h)
Weist die Texturverwaltungspriorität für diese Textur zu. Diese Methode ist nur bei verwalteten Texturen erfolgreich.
Syntax
HRESULT SetPriority(
[in] DWORD unnamedParam1
);
Parameter
[in] unnamedParam1
Ein -Wert, der die neue Texturverwaltungspriorität für die Textur angibt.
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
SetPriority wurde mit der IDirectDrawSurface7-Schnittstelle eingeführt.
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 die gleiche 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 flag DDSCAPS2_TEXTUREMANAGE erstellt wurden) festlegen und abrufen. Wenn Sie SetPriority für eine nicht verwaltete Textur aufrufen, schlägt SetPriority fehl und gibt DDERR_INVALIDOBJECT zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |