Partager via


structure DD_GETEXTENDEDMODEDATA (d3dhal.h)

DirectX 9.0 et versions ultérieures uniquement.

DD_GETEXTENDEDMODEDATA est la structure de données pointée par le champ lpvData de DD_GETDRIVERINFODATA pour les requêtes DD_GETDRIVERINFO2DATA avec le type D3DGDI2_TYPE_GETEXTENDEDMODE.

Syntaxe

typedef struct _DD_GETEXTENDEDMODEDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwModeIndex;
  D3DDISPLAYMODE        mode;
} DD_GETEXTENDEDMODEDATA;

Membres

gdi2

Spécifie une structure DD_GETDRIVERINFO2DATA qui contient les données GetDriverInfo2.

dwModeIndex

Spécifie l’index du mode d’affichage à retourner.

mode

Reçoit une structure D3DDISPLAYMODE qui spécifie le mode d’affichage réel.

Remarques

Le runtime identifie le mode d’affichage à retourner avec un index entier dont la valeur varie entre zéro et un nombre inférieur au nombre de modes d’affichage pris en charge signalés précédemment par le pilote dans une requête DD_GETDRIVERINFO2DATA avec le type D3DGDI2_TYPE_GETEXTENDEDMODECOUNT. La façon dont ces index sont mappés aux modes d’affichage réels est laissé au pilote. Toutefois, chaque index doit être mappé de manière unique à un mode d’affichage pris en charge. L’ordre dans lequel les modes d’affichage sont signalés n’est pas significatif.

Lors du traitement de cette GetDriverInfo2 demander au pilote de lire la valeur dans le membre dwModeIndex et mapper cette valeur à l’un des modes d’affichage pris en charge (probablement en utilisant la valeur dans dwModeIndex en tant qu’index dans un tableau de structures D3DDISPLAYMODE). Le pilote doit ensuite copier ce mode d’affichage dans le mode membre. Le runtime garantit qu’il transmet uniquement un index au pilote qui se trouve dans la plage zéro à un seul moins que le nombre de modes d’affichage signalés par le pilote. La plage de l’index doit être validée dans la build du pilote de débogage.

Pour plus d’informations sur D3DDISPLAYMODE, consultez la documentation du Kit de développement logiciel (SDK) DirectX.

Exigences

Exigence Valeur
d’en-tête d3dhal.h (include D3dhal.h)

Voir aussi

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA

DD_GETEXTENDEDMODECOUNTDATA