Partager via


DD_GETEXTENDEDMODEDATA structure (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 de moins que le nombre de modes d’affichage pris en charge qui ont été 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ée 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 requête GetDriverInfo2 , le pilote doit 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 comme index dans un tableau de structures D3DDISPLAYMODE). Le pilote doit ensuite copier ce mode d’affichage dans le membre du mode . Le runtime garantit qu’il transmet uniquement un index au pilote compris entre zéro et un de 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.

Configuration requise

Condition requise Valeur
En-tête d3dhal.h (inclure D3dhal.h)

Voir aussi

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA

DD_GETEXTENDEDMODECOUNTDATA