D3DKMTGetDisplayModeList, fonction (d3dkmthk.h)
La fonction D3DKMTGetDisplayModeList récupère une liste des modes d’affichage disponibles, y compris les modes avec un 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 de retour
D3DKMTGetDisplayModeList retourne une valeur NTSTATUS comme 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 égal à zéro lors de l’entrée. |
| STATUS_DEVICE_REMOVED | La carte graphique a été arrêtée. |
| STATUS_BUFFER_TOO_SMALL | Mémoire tampon fournie par le pilote client dans pData->pModeList n’est pas suffisamment grande pour contenir la liste des modes d’affichage demandés. |
| STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET | Aucune cible présente vidéo n’est disponible pour une utilisation avec la source présente de la 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 de modes d’affichage de 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 comme 0. Si cet appel retourne STATUS_SUCCESS, le pData->ModeCount retourné correspond au nombre total de modes d’affichage. Le pilote client peut ensuite allouer un tableau de structures ModeCountD3DKMT_DISPLAYMODE, définir pModeList pointer vers ce tableau et appeler D3DKMTGetDisplayModeList pour récupérer à nouveau la liste des modes d’affichage.
Les attributs d’affichage de 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 suffisamment grand pour contenir la nouvelle liste du mode d’affichage, cette fonction retourne STATUS_BUFFER_TOO_SMALL avec le nombre de 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 du mode d’affichage.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Universel |
| d’en-tête | d3dkmthk.h (include D3dkmthk.h) |
| bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |