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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |