Funzione GetDisplayConfigBufferSizes (winuser.h)
La funzione GetDisplayConfigBufferSizes recupera le dimensioni dei buffer necessari per chiamare la funzione QueryDisplayConfig .
Sintassi
LONG GetDisplayConfigBufferSizes(
[in] UINT32 flags,
[out] UINT32 *numPathArrayElements,
[out] UINT32 *numModeInfoArrayElements
);
Parametri
[in] flags
Tipo di informazioni da recuperare. Il valore per il parametro Flags deve essere uno dei valori seguenti.
QDC_ALL_PATHS
Il chiamante richiede le dimensioni della tabella per contenere tutte le possibili combinazioni di percorso.
QDC_ONLY_ACTIVE_PATHS
Il chiamante richiede le dimensioni della tabella per contenere solo i percorsi attivi.
QDC_DATABASE_CURRENT
Il chiamante richiede le dimensioni della tabella per contenere i percorsi attivi come definito nel database di persistenza per i monitoraggi attualmente connessi.
[out] numPathArrayElements
Puntatore a una variabile che riceve il numero di elementi nella tabella delle informazioni sul percorso. Il valore del parametro pNumPathArrayElements viene quindi usato da una chiamata successiva alla funzione QueryDisplayConfig . Questo parametro non può essere NULL.
[out] numModeInfoArrayElements
Puntatore a una variabile che riceve il numero di elementi nella tabella delle informazioni sulla modalità. Il valore del parametro pNumModeInfoArrayElements viene quindi usato da una chiamata successiva alla funzione QueryDisplayConfig . Questo parametro non può essere NULL.
Valore restituito
La funzione restituisce uno dei codici restituiti seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Funzione completata. |
|
La combinazione di parametri e flag specificati non è valida. |
|
Il sistema non esegue un driver grafico scritto in base al modello wdDM (Display Driver Model) di Windows. La funzione è supportata solo in un sistema con un driver WDDM in esecuzione. |
|
Il chiamante non ha accesso alla sessione della console. Questo errore si verifica se il processo di chiamata non ha accesso al desktop corrente o è in esecuzione in una sessione remota. |
|
Si è verificato un errore non specificato. |
Commenti
Dato la configurazione del percorso di visualizzazione corrente e i flag richiesti, GetDisplayConfigBufferSizes restituisce le dimensioni delle tabelle percorso e modalità necessarie per archiviare le informazioni. GetDisplayConfigBufferSizes può restituire valori leggermente superiori a quelli effettivamente necessari perché determina che tutti i percorsi di origine e di destinazione sono validi; mentre il driver potrebbe porre alcune restrizioni sulle possibili combinazioni.
Poiché GetDisplayConfigBufferSizes può determinare solo le dimensioni necessarie della matrice del momento, è possibile che tra le chiamate a GetDisplayConfigBufferSizes e QueryDisplayConfig la configurazione del sistema sia stata modificata e le dimensioni della matrice fornite non siano più sufficienti per archiviare i nuovi dati del percorso.
Se un chiamante è consapevole che deve abilitare origini e destinazioni aggiuntive, il chiamante può allocare una matrice di informazioni in modalità più grande rispetto a quella restituita da GetDisplayConfigBufferSizes in modo che abbia lo spazio per aggiungere le modalità di origine e destinazione aggiuntive dopo aver chiamato QueryDisplayConfig e prima di chiamare SetDisplayConfig.
Esempio
Vedere QueryDisplayConfig per un esempio di GetDisplayConfigBufferSizes.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib; OneCoreUAP.lib in Windows 10 |
| DLL | User32.dll |
| Set di API | ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introdotta in Windows 10, versione 10.0.14393) |