Método IDirectDrawSurface7::SetPriority (ddraw.h)

Atribui a prioridade de gerenciamento de textura para essa textura. Esse método só tem êxito em texturas gerenciadas.

Sintaxe

HRESULT SetPriority(
  [in] DWORD unnamedParam1
);

Parâmetros

[in] unnamedParam1

Um valor que especifica a nova prioridade de gerenciamento de textura para a textura.

Retornar valor

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o valor retornado será um erro. O método retornará DDERR_INVALIDOBJECT se o parâmetro for inválido ou se a textura não for gerenciada pelo Direct3D.

Comentários

SetPriority foi introduzido com a interface IDirectDrawSurface7 .

As prioridades são usadas para determinar quando as texturas gerenciadas devem ser removidas da memória. Uma textura atribuída a uma baixa prioridade é removida antes de uma textura com alta prioridade. Se duas texturas tiverem a mesma prioridade, a textura usada mais recentemente será mantida na memória; a outra textura é removida.

Os aplicativos podem definir e recuperar prioridades apenas para texturas gerenciadas (aquelas superfícies que foram criadas com o sinalizador DDSCAPS2_TEXTUREMANAGE). Se você chamar SetPriority em uma textura não gerenciada, SetPriority falhará e retornará DDERR_INVALIDOBJECT.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	ddraw.h
Biblioteca	Ddraw.lib
DLL	Ddraw.dll

Confira também

IDirectDrawSurface7