Metodo IDirectDrawSurface7::SetPriority (ddraw.h)

Assegna la priorità di gestione della trama per questa trama. Questo metodo ha esito positivo solo sulle trame gestite.

Sintassi

HRESULT SetPriority(
  [in] DWORD unnamedParam1
);

Parametri

[in] unnamedParam1

Valore che specifica la nuova priorità di gestione della trama per la trama.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è DD_OK.

Se ha esito negativo, il valore restituito è un errore. Il metodo restituisce DDERR_INVALIDOBJECT se il parametro non è valido o se la trama non è gestita da Direct3D.

Commenti

SetPriority è stato introdotto con l'interfaccia IDirectDrawSurface7 .

Le priorità vengono usate per determinare quando le trame gestite devono essere rimosse dalla memoria. Una trama assegnata a una priorità bassa viene rimossa prima di una trama con priorità elevata. Se due trame hanno la stessa priorità, la trama usata più di recente viene mantenuta in memoria; l'altra trama viene rimossa.

Le applicazioni possono impostare e recuperare le priorità solo per le trame gestite (quelle superfici create con il flag di DDSCAPS2_TEXTUREMANAGE). Se si chiama SetPriority in una trama non gestita, SetPriority ha esito negativo e restituisce DDERR_INVALIDOBJECT.

Requisiti

Vedi anche

IDirectDrawSurface7