structure D3DDDIARG_OPENADAPTER (d3dumddi.h)

  • Article

La structure D3DDDIARG_OPENADAPTER contient des informations qui décrivent l’objet d’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 d’adaptateur graphique. Lors de l’entrée dans la fonction OpenAdapter , hAdapter spécifie le handle que le pilote doit utiliser pour interroger les fonctionnalités de la carte graphique lorsque le pilote appelle la fonction de rappel pfnQueryAdapterInfoCb fournie par le runtime Microsoft Direct3D.

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

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é créé. Par exemple, le pilote peut utiliser le numéro de version pour faire la différence entre un runtime publié avec Windows Vista et un runtime publié avec un Service Pack suivant, qui peut contenir un correctif requis par le pilote.

[in] pAdapterCallbacks

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

[out] pAdapterFuncs

Pointeur vers une structure de D3DDDI_ADAPTERFUNCS qui contient une table de 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 à la carte 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 laquelle le pilote a été compilé. Le pilote d’affichage en mode utilisateur doit retourner D3D_UMD_INTERFACE_VERSION.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête d3dumddi.h (inclure D3dumddi.h)

Voir aussi

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb