共用方式為


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

另請參閱

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3