structure D3DKMT_ENUMADAPTERS3 (d3dkmthk.h)
La structure D3DKMT_ENUMADAPTERS3 fournit des informations sur les adaptateurs sur le système.
Syntaxe
typedef struct _D3DKMT_ENUMADAPTERS3 {
[in] D3DKMT_ENUMADAPTERS_FILTER Filter;
[in/out] ULONG NumAdapters;
[out] D3DKMT_ADAPTERINFO *pAdapters;
} D3DKMT_ENUMADAPTERS3;
Membres
[in] Filter
Union D3DKMT_ENUMADAPTERS_FILTER contenant des indicateurs de filtre pour l’énumération. Le struct dans filtre peut être une or au niveau du bit des valeurs suivantes. Pour plus d’informations, consultez les remarques.
| Valeur | Signification |
|---|---|
| IncludeComputeOnly | Quand elle est définie, énumérez les adaptateurs ComputeOnly. |
| IncludeDisplayOnly | Quand elle est définie, énumérez les adaptateurs DisplayOnly. |
| IncludeVirtualGpuOnly | Lorsqu’il est défini, énumérez les adaptateurs GPU-P. Ces adaptateurs sont destinés à être utilisés uniquement à l’intérieur des machines virtuelles. Un pilote définit la limite DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly pour ces adaptateurs afin d’éviter leur énumération dans le système d’exploitation hôte. Disponible à partir de Windows 11, version 24H2 (WDDM 3.2). |
| Réservé | Réservé; n’utilisez pas. |
[in/out] NumAdapters
Nombre d’adaptateurs.
Lors de l’entrée, NumAdapters spécifie le nombre d’adaptateurs pouvant être retournés dans le tableau pAdapters vides. Les valeurs de retour possibles pour NumAdapters sont les suivantes :
- Lors d’un retour réussi lorsque
pAdapters n’est pas null,NumAdapters contient le nombre d’adaptateurs retournés dans le tableau pAdapters. - En cas de retour réussi lorsque pAdapters a la valeur Null, NumAdapters contient le nombre maximal d’adaptateurs pris en charge.
- Lors de l’échec du retour lorsque pAdapters n’a pas la valeur Null, NumAdapters n’est pas défini.
[out] pAdapters
Tableau facultatif de structures D3DKMT_ADAPTERINFO dans lesquelles recevoir des informations pour chaque adaptateur.
Remarques
Les adaptateurs sont toujours énumérés si aucun indicateur n’est défini dans filtre, mais D3DKMTEnumAdapters3 énumère moins d’adaptateurs que D3DKMTEnumAdapters2. Plus précisément, D3DKMTEnumAdapters3 :
- Laissez les adaptateurs ComputeOnly de l’énumération par défaut pour éviter les applications cassants.
- Laissez les adaptateurs DisplayOnly hors de l’énumération par défaut.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 2004 |
| d’en-tête | d3dkmthk.h |