次の方法で共有

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 列挙します。 これらのアダプターは、仮想マシン内でのみ使用されます。 ドライバーは、ホスト OS での列挙を回避するために、このようなアダプターの DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly 上限を設定します。 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 構造体の省略可能な配列。

備考

フィルターにフラグが設定されていない場合でもアダプターは列挙されますが、D3DKMTEnumAdapters3 では、D3DKMTEnumAdapters2よりも少ないアダプターが列挙されます。 具体的には、D3DKMTEnumAdapters3 は次のようになります。

  • アプリケーションの中断を回避するため、ComputeOnly アダプターは既定の列挙型から除外します。
  • DisplayOnly アダプターは既定の列挙型から除外します。

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 2004
ヘッダー d3dkmthk.h

関連項目

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3