struttura D3DKMT_ENUMADAPTERS3 (d3dkmthk.h)

Articolo
10/23/2024

La struttura D3DKMT_ENUMADAPTERS3 fornisce informazioni sugli adattatori nel sistema.

Sintassi

typedef struct _D3DKMT_ENUMADAPTERS3 {
  [in]     D3DKMT_ENUMADAPTERS_FILTER Filter;
  [in/out] ULONG                      NumAdapters;
  [out]    D3DKMT_ADAPTERINFO         *pAdapters;
} D3DKMT_ENUMADAPTERS3;

Membri

[in] Filter

Unione D3DKMT_ENUMADAPTERS_FILTER contenente i flag di filtro per l'enumerazione. Lo struct in Filter può essere un OR bit per bit dei valori seguenti. Per altre informazioni, vedere La sezione Osservazioni.

Valore	Significato
IncludeComputeOnly	Se impostata, enumerare le schede ComputeOnly.
IncludeDisplayOnly	Se impostata, enumerare gli adattatori DisplayOnly.
IncludeVirtualGpuOnly	Se impostata, enumerare GPU-P adapter. Questi adattatori devono essere usati solo all'interno di macchine virtuali. Un driver imposta il limite di DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly per tali adattatori per evitare l'enumerazione nel sistema operativo host. Disponibile a partire da Windows 11 versione 24H2 (WDDM 3.2).
Riservato	Riservato; non usare.

[in/out] NumAdapters

Numero di adattatori.

In caso di input, NumAdapters specifica il numero di adattatori che è possibile restituire nella matrice pAdapters vuota . I possibili valori restituiti per NumAdapter sono:

In caso di esito positivo, quando pAdapters è diverso da Null, NumAdapters contiene il numero di adattatori restituiti nella matrice pAdapters.
In caso di esito positivo, quando pAdapters è Null, NumAdapters contiene il numero massimo di adattatori supportato.
Se non è possibile restituire quando pAdapters è diverso da null, NumAdapters non è definito.

[out] pAdapters

Matrice facoltativa di strutture di D3DKMT_ADAPTERINFO in cui ricevere informazioni per ogni adattatore.

Osservazioni

Gli adapter verranno comunque enumerati se non sono impostati flag in Filter, ma D3DKMTEnumAdapters3 enumererà meno adattatori rispetto a D3DKMTEnumAdapters2. In particolare, D3DKMTEnumAdapters3:

Lasciare gli adattatori ComputeOnly dall'enumerazione predefinita per evitare l'interruzione delle applicazioni.
Lasciare gli adattatori DisplayOnly dall'enumerazione predefinita.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 2004
intestazione	d3dkmthk.h

Vedere anche

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3

Condividi tramite