funzione glAreTexturesResident
La funzione glAreTexturesResident determina se gli oggetti trama specificati risiedono nella memoria della trama.
Sintassi
GLboolean WINAPI glAreTexturesResident(
GLsizei n,
const GLuint *textures,
GLboolean *residences
);
Parametri
-
n
-
Numero di trame su cui eseguire una query.
-
Texture
-
Indirizzo di una matrice contenente i nomi delle trame su cui eseguire una query.
-
Residence
-
Indirizzo di una matrice in cui viene restituito lo stato di residenza della trama. Lo stato di residenza di una trama denominata da un elemento di trame viene restituito nell'elemento corrispondente delle abitazioni.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
n era un valore negativo, un elemento nelle trame era zero o un elemento nelle trame non contiene un identificatore di trama. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
Nei computer con una quantità limitata di memoria della trama, OpenGL stabilisce un working set di trame residenti nella memoria della trama. Queste trame possono essere associate a una destinazione di trama in modo molto più efficiente rispetto alle trame non residenti.
La funzione glAreTexturesResident esegue una query sullo stato di residenza della trama delle trame n denominate dagli elementi delle trame. Se tutte le trame denominate sono residenti, glAreTexturesResident restituisce GL_TRUE e il contenuto delle abitazioni non è indisturbato. Se una delle trame denominate non è residente, glAreTexturesResident restituisce GL_FALSE e lo stato dettagliato viene restituito negli n elementi delle abitazioni.
Se un elemento di residence è GL_TRUE, la trama denominata dall'elemento corrispondente delle trame risiede nella memoria della trama.
Per eseguire una query sullo stato di residenza di una singola trama associata, chiamare glGetTexParameter con il parametro di destinazione impostato sulla trama di destinazione a cui è associata la destinazione e impostare il parametro pname su GL_TEXTURE_RESIDENT. È necessario usare questo metodo per eseguire una query sullo stato residente di una trama predefinita.
Non è possibile includere glAreTexturesResident negli elenchi di visualizzazione.
La funzione glAreTexturesResident restituisce lo stato di residenza delle trame al momento della chiamata. Non garantisce che le trame rimangano residenti in qualsiasi altro momento.
Se le trame risiedono nella memoria virtuale (non esiste memoria trama), vengono considerate sempre residenti.
Nota
La funzione glAreTexturesResident è disponibile solo in OpenGL versione 1.1 o successiva.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|