Partager via

structure D3DDDIARG_OPENADAPTER (d3dumddi.h)

  • Article

La structure D3DDDIARG_OPENADAPTER contient des informations qui décrivent l’objet adaptateur graphique.

Syntaxe

typedef struct _D3DDDIARG_OPENADAPTER {
  [in/out] HANDLE                        hAdapter;
  [in]     UINT                          Interface;
  [in]     UINT                          Version;
  [in]     const D3DDDI_ADAPTERCALLBACKS *pAdapterCallbacks;
  [out]    D3DDDI_ADAPTERFUNCS           *pAdapterFuncs;
  [out]    UINT                          DriverVersion;
} D3DDDIARG_OPENADAPTER;

Membres

[in/out] hAdapter

Handle de l’objet adaptateur graphique. Lors de l’entrée de la fonction OpenAdapter, hAdapter spécifie le handle que le pilote doit utiliser pour rechercher des fonctionnalités de carte graphique lorsque le pilote appelle la fonction de rappel fournie par le runtime Microsoft Direct3D pfnQueryAdapterInfoCb fonction de rappel.

Le pilote génère un handle unique et le transmet au runtime Direct3D. Lors de la sortie de la fonction OpenAdapter, hAdapter spécifie le handle que le runtime Direct3D utilise dans les appels de pilotes suivants pour identifier l’objet de carte graphique.

[in] Interface

La version de l’interface Direct3D/DirectDraw (par exemple, 7, 8 ou 9) qui ouvre la carte graphique.

[in] Version

Nombre que le pilote peut utiliser pour identifier le moment où le runtime Direct3D/DirectDraw a été généré. Par exemple, le pilote peut utiliser le numéro de version pour différencier un runtime publié avec Windows Vista et un runtime publié avec un Service Pack ultérieur, qui peut contenir un correctif requis par le pilote.

[in] pAdapterCallbacks

Pointeur vers une structure D3DDDI_ADAPTERCALLBACKS qui contient la fonction de rappel fournie par le runtime Direct3D pfnQueryAdapterInfoCb fonction de rappel que le pilote peut utiliser.

[out] pAdapterFuncs

Pointeur vers une structure D3DDDI_ADAPTERFUNCS qui contient une table des fonctions spécifiques à l’adaptateur de pilote d’affichage en mode utilisateur. Le runtime Direct3D utilise ces fonctions pour communiquer avec le pilote d’affichage en mode utilisateur sur les opérations spécifiques à l’adaptateur graphique.

[out] DriverVersion

Version de l’interface du pilote d’affichage en mode utilisateur Direct3D obtenue à partir du fichier d’en-tête D3dumddi.h avec lequel le pilote a été compilé. Le pilote d’affichage en mode utilisateur doit retourner D3D_UMD_INTERFACE_VERSION.

Remarque Si un pilote en mode utilisateur ne prend pas en charge les fonctionnalités windows 7 (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7) et que vous souhaitez compiler le pilote avec Windows 7 WDK (version 7600), assurez-vous que le pilote retourne D3D_UMD_INTERFACE_VERSION_VISTA.
 

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
d’en-tête d3dumddi.h (include D3dumddi.h)

Voir aussi

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb