Funzione D3DKMTGetDisplayModeList (d3dkmthk.h)

La funzione D3DKMTGetDisplayModeList recupera un elenco di 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> era NULL e pData-ModeCount> era 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 è sufficientemente grande da contenere l'elenco delle modalità di visualizzazione richieste.
STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET	Nessuna destinazione presente video è disponibile per l'uso con l'origine presente video 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 come non corretti.

Commenti

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, il valore pData-ModeCount> restituito corrisponde al numero totale delle modalità di visualizzazione. Il driver client può quindi allocare una matrice di strutture ModeCountD3DKMT_DISPLAYMODE , impostare pModeList in modo che punti a questa matrice e chiamare di nuovo D3DKMTGetDisplayModeList per recuperare l'elenco delle modalità di visualizzazione.

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.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Piattaforma di destinazione	Universale
Intestazione	d3dkmthk.h (include D3dkmthk.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll

Vedi anche

D3DKMT_DISPLAYMODE

D3DKMT_GETDISPLAYMODELIST