D3DKMT_ENUMADAPTERS3 Struktur (d3dkmthk.h)
Die D3DKMT_ENUMADAPTERS3 Struktur liefert Informationen zu Adaptern auf dem System.
Syntax
typedef struct _D3DKMT_ENUMADAPTERS3 {
[in] D3DKMT_ENUMADAPTERS_FILTER Filter;
[in/out] ULONG NumAdapters;
[out] D3DKMT_ADAPTERINFO *pAdapters;
} D3DKMT_ENUMADAPTERS3;
Angehörige
[in] Filter
Eine D3DKMT_ENUMADAPTERS_FILTER Union, die Filterkennzeichnungen für die Enumeration enthält. Die Struktur in Filter kann ein bitweiser ODER der folgenden Werte sein. Weitere Informationen finden Sie in den Hinweisen.
| Wert | Bedeutung |
|---|---|
| IncludeComputeOnly | Wenn diese Einstellung festgelegt ist, führen Sie ComputeOnly-Adapter auf. |
| IncludeDisplayOnly | Wenn diese Einstellung festgelegt ist, führen Sie DisplayOnly-Adapter auf. |
| IncludeVirtualGpuOnly | Wenn diese Einstellung festgelegt ist, führen Sie GPU-P Adapter auf. Diese Adapter sollen nur in virtuellen Computern verwendet werden. Ein Treiber legt die DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly Cap für solche Adapter fest, um die Enumeration im Hostbetriebssystem zu vermeiden. Verfügbar ab Windows 11, Version 24H2 (WDDM 3.2). |
| Reserviert | Reserviert; nicht verwenden. |
[in/out] NumAdapters
Die Anzahl der Adapter.
Bei eingaben gibt NumAdapters an, wie viele Adapter im leeren pAdapters Array zurückgegeben werden können. Mögliche Rückgabewerte für NumAdapters sind:
- Bei erfolgreicher Rückgabe, wenn pAdapters- ungleich NULL ist, enthält NumAdapters-, wie viele Adapter im pAdapters Array zurückgegeben wurden.
- Bei erfolgreicher Rückgabe, wenn pAdapters- null ist, enthält NumAdapters- die maximal unterstützte Adapteranzahl.
- Fehler beim Zurückgeben, wenn pAdapters- ungleich NULL ist, NumAdapters- nicht definiert ist.
[out] pAdapters
Ein optionales Array von D3DKMT_ADAPTERINFO Strukturen, in denen Informationen für jeden Adapter empfangen werden sollen.
Bemerkungen
Adapter werden weiterhin aufgezählt, wenn keine Flags in Filter-festgelegt sind, aber D3DKMTEnumAdapters3 werden weniger Adapter als D3DKMTEnumAdapters2aufgezählt. Insbesondere D3DKMTEnumAdapters3:
- Verlassen Sie ComputeOnly-Adapter aus der Standardenumeration, um zu vermeiden, dass Anwendungen abgebrochen werden.
- Lassen Sie DisplayOnly-Adapter aus der Standardenumeration aus.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 2004 |
| Header- | d3dkmthk.h |