Partager via


DD_GETFORMATDATA structure (d3dhal.h)

DirectX 8.0 et versions ultérieures uniquement.

DD_GETFORMATDATA est la structure de données vers laquelle pointe le champ lpvData de DD_GETDRIVERINFODATA pour les requêtes DD_GETDRIVERINFO2DATA avec le type D3DGDI2_TYPE_GETFORMAT.

Syntaxe

typedef struct _DD_GETFORMATDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwFormatIndex;
  DDPIXELFORMAT         format;
} DD_GETFORMATDATA;

Membres

gdi2

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

dwFormatIndex

Spécifie l’index du format de pixel à retourner.

format

Reçoit le format de pixel réel dans une structure DDPIXELFORMAT .

Remarques

Le runtime identifie le format à retourner avec un index entier dont la valeur varie entre zéro et un de moins que le nombre de formats pris en charge signalés précédemment par le pilote. La façon dont ces index sont mappés aux formats réels est laissée au pilote. Toutefois, chaque index doit être mappé de manière unique à un format pris en charge. L’ordre dans lequel les formats sont signalés n’est pas significatif.

Lors du traitement de cette demande GetDriverInfo2 , le pilote doit lire le dwFormatIndex et le mapper à l’un des formats pris en charge (probablement en utilisant dwFormatIndex comme index dans un tableau de structures DDPIXELFORMAT), puis copier ce format dans le champ format du champ DD_GETFORMATDATA. Le runtime garantit qu’il transmet uniquement un index au pilote compris entre zéro et un de moins que le nombre de formats de surface signalés par le pilote. La plage de l’index doit être validée dans la build du pilote de débogage.

DirectX 9.0 et versions ultérieures uniquement.Lors de l’entrée, la version du runtime DirectX utilisée par l’application est spécifiée dans le membre dwSize de la structure DDPIXELFORMAT au format. Ce membre dwSize est défini sur DD_RUNTIME_VERSION, ce qui est 0x00000900 pour DirectX 9.0.

Configuration requise

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

Voir aussi

DDPIXELFORMAT

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA