Funzione D3DKMTGetDisplayModeList (d3dkmthk.h)
La funzione D3DKMTGetDisplayModeList recupera un elenco delle modalità di visualizzazione disponibili, incluse le modalità con formato esteso.
Sintassi
NTSTATUS D3DKMTGetDisplayModeList(
D3DKMT_GETDISPLAYMODELIST *unnamedParam1
);
Parametri
unnamedParam1
[in/out] pData è un puntatore a una struttura D3DKMT_GETDISPLAYMODELIST che contiene gli argomenti per questa funzione.
Valore restituito
D3DKMTGetDisplayModeList restituisce un valore NTSTATUS, ad esempio uno dei seguenti.
| codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | L'elenco delle modalità di visualizzazione disponibili è stato recuperato correttamente oppure il numero di modalità di visualizzazione è stato restituito in pData->ModeCount se pData->pModeList è null e pData->ModeCount è stato zero all'input. |
| STATUS_DEVICE_REMOVED | La scheda grafica è stata arrestata. |
| STATUS_BUFFER_TOO_SMALL | Il buffer fornito dal driver client in pData->pModeList non è sufficiente per contenere l'elenco di modalità di visualizzazione richiesta. |
| STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET | Nessuna destinazione presente video è disponibile per l'uso con l'origine del video presente identificata da pData->VidPnSourceId. Pertanto, non sono disponibili modalità di visualizzazione per questa origine. |
| STATUS_INVALID_PARAMETER** | I parametri sono stati convalidati e sono stati determinati in modo che non siano corretti. |
Osservazioni
Per ottenere il numero di modalità di visualizzazione per l'origine VidPn specificata (pData->VidPnSourceId) nella scheda grafica (pData->hAdapter), un driver client può chiamare D3DKMTGetDisplayModeList con pData->pModeList impostato su NULL e pData->ModeCount come 0. Se questa chiamata restituisce STATUS_SUCCESS, la
Gli attributi di visualizzazione nell'origine VidPn specificata possono essere modificati tra queste due chiamate, causando la modifica dell'elenco delle modalità di visualizzazione. In questo caso, se la matrice di D3DKMT_DISPLAYMODE fornita dal chiamante non è sufficientemente grande da contenere il nuovo elenco di modalità di visualizzazione, questa funzione restituirà STATUS_BUFFER_TOO_SMALL con il numero delle nuove modalità di visualizzazione nel ModeCount restituito. Il chiamante può liberare la matrice di D3DKMT_DISPLAYMODE precedente, allocare una nuova matrice di D3DKMT_DISPLAYMODE in base al nuovo numero restituito e chiamare di nuovo questa funzione con il nuovo numero e la nuova matrice D3DKMT_DISPLAYMODE per ottenere il nuovo elenco di modalità di visualizzazione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Universale |
| intestazione |
d3dkmthk.h (include D3dkmthk.h) |
| libreria |
Gdi32.lib |
| dll | Gdi32.dll |