Fonction D3DKMTGetDisplayModeList (d3dkmthk.h)

La fonction D3DKMTGetDisplayModeList récupère une liste des modes d’affichage disponibles, y compris les modes au format étendu.

Syntaxe

NTSTATUS D3DKMTGetDisplayModeList(
  D3DKMT_GETDISPLAYMODELIST *unnamedParam1
);

Paramètres

unnamedParam1

[in/out] pData est un pointeur vers une structure D3DKMT_GETDISPLAYMODELIST qui contient les arguments de cette fonction.

Valeur retournée

D3DKMTGetDisplayModeList retourne une valeur NTSTATUS telle que l’une des valeurs suivantes.

Code de retour	Description
STATUS_SUCCESS	La liste des modes d’affichage disponibles a été récupérée avec succès, ou le nombre de modes d’affichage a été retourné dans pData-ModeCount> si pData-pModeList> était NULL et pData-ModeCount> était nul en entrée.
STATUS_DEVICE_REMOVED	La carte graphique a été arrêtée.
STATUS_BUFFER_TOO_SMALL	La mémoire tampon fournie par le pilote client dans pData-pModeList> n’est pas suffisamment grande pour contenir la liste de mode d’affichage demandée.
STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET	Aucune cible de présentation vidéo n’est disponible pour une utilisation avec la source de présentation vidéo identifiée par pData-VidPnSourceId>. Par conséquent, aucun mode d’affichage n’est disponible pour cette source.
STATUS_INVALID_PARAMETER**	Les paramètres ont été validés et déterminés comme incorrects.

Remarques

Pour obtenir le nombre des modes d’affichage pour la source VidPn spécifiée (pData-VidPnSourceId>) sur la carte graphique (pData-hAdapter>), un pilote client peut appeler D3DKMTGetDisplayModeList avec pData-pModeList> défini sur NULL et pData-ModeCount> sur 0. Si cet appel retourne STATUS_SUCCESS, le pData-ModeCount> retourné est le nombre total des modes d’affichage. Le pilote client peut ensuite allouer un tableau de structures ModeCountD3DKMT_DISPLAYMODE , définir pModeList pour pointer vers ce tableau et appeler à nouveau D3DKMTGetDisplayModeList pour récupérer la liste des modes d’affichage.

Les attributs d’affichage sur la source VidPn spécifiée peuvent être modifiés entre ces deux appels, ce qui entraîne la modification de la liste des modes d’affichage. Dans ce cas, si le tableau D3DKMT_DISPLAYMODE fourni par l’appelant n’est pas assez grand pour contenir la nouvelle liste des modes d’affichage, cette fonction retourne STATUS_BUFFER_TOO_SMALL avec le nombre des nouveaux modes d’affichage dans le ModeCount retourné. L’appelant peut libérer le tableau de D3DKMT_DISPLAYMODE précédent, allouer un nouveau tableau D3DKMT_DISPLAYMODE en fonction du nouveau numéro retourné et appeler à nouveau cette fonction avec le nouveau numéro et le nouveau tableau D3DKMT_DISPLAYMODE pour obtenir la nouvelle liste de mode d’affichage.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Universal
En-tête	d3dkmthk.h (inclure D3dkmthk.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Voir aussi

D3DKMT_DISPLAYMODE

D3DKMT_GETDISPLAYMODELIST