D3DKMT_ENUMADAPTERS3結構(d3dkmthk.h)
D3DKMT_ENUMADAPTERS3 結構會提供系統上適配卡的相關信息。
語法
typedef struct _D3DKMT_ENUMADAPTERS3 {
[in] D3DKMT_ENUMADAPTERS_FILTER Filter;
[in/out] ULONG NumAdapters;
[out] D3DKMT_ADAPTERINFO *pAdapters;
} D3DKMT_ENUMADAPTERS3;
成員
[in] Filter
包含列舉之篩選旗標的 D3DKMT_ENUMADAPTERS_FILTER 聯集。 Filter 中的結構可以是下列值的位 OR。 如需詳細資訊,請參閱。
價值 | 意義 |
---|---|
IncludeComputeOnly | 設定時,列舉 ComputeOnly 配接器。 |
IncludeDisplayOnly | 設定時,列舉 DisplayOnly 配接器。 |
IncludeVirtualGpuOnly | 設定時,列舉 GPU-P 配接器。 這些適配卡只用於虛擬機內。 驅動程式會設定這類適配卡的 DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly 上限,以避免其在主機 OS 中列舉。 從 Windows 11 版本 24H2 (WDDM 3.2) 開始提供。 |
保留 | 保留;請勿使用 。 |
[in/out] NumAdapters
配接器的數目。
在輸入時,NumAdapters 會指定在空 pAdapters 陣列中可以傳回多少個適配卡。 NumAdapters 的可能傳回值為:
- 當
pAdapters 為非 Null 時,NumAdapters 包含 pAdapters 陣列傳回的配接器數目。 - 當 pAdapters
為 null 時, NumAdapters 包含支援的配接器計數上限時,傳回成功。 - 當 pAdapters
為非 Null 時,傳回失敗時, 未定義 NumAdapters 。
[out] pAdapters
選擇性的 D3DKMT_ADAPTERINFO 結構陣列,用來接收每個配接器的資訊。
言論
如果 Filter中未設定旗標,仍然會列舉配接器,但 D3DKMTEnumAdapters3 會列舉比 D3DKMTEnumAdapters2更少的配接器。 具體而言,D3DKMTEnumAdapters3:
- 將 ComputeOnly 配接器排除在預設列舉中,以避免中斷應用程式。
- 將 DisplayOnly 配接器排除在預設列舉中。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 2004 |
標頭 | d3dkmthk.h |