Metodo IDirectDrawSurface7::GetPriority (ddraw.h)

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

Sintassi

HRESULT GetPriority(
  [out] LPDWORD unnamedParam1
);

Parametri

[out] unnamedParam1

Puntatore a una variabile che riceve la priorità della trama se la chiamata ha esito positivo.

Valore restituito

Se il metodo ha esito positivo, il valore restituito viene 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

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à alta. 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 create con il flag DDSCAPS2_TEXTUREMANAGE). Se si chiama GetPriority in una trama non gestita, GetPriority ha esito negativo e restituisce DDERR_INVALIDOBJECT.

GetPriority è stato introdotto con l'interfaccia IDirectDrawSurface7 .

Requisiti

Vedi anche

IDirectDrawSurface7