Compartilhar via


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

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

Sintaxe

HRESULT GetPriority(
  [out] LPDWORD unnamedParam1
);

Parâmetros

[out] unnamedParam1

Um ponteiro para uma variável que recebe a prioridade de textura se a chamada for bem-sucedida.

Valor retornado

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

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 GetPriority em uma textura não gerenciada, GetPriority falhará e retornará DDERR_INVALIDOBJECT.

GetPriority foi introduzido com a interface IDirectDrawSurface7 .

Requisitos

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

Confira também

IDirectDrawSurface7