次の方法で共有

DXGK_QUERYADAPTERINFOTYPE列挙 (d3dkmddi.h)

  • [アーティクル]

DXGK_QUERYADAPTERINFOTYPE列挙は、カーネル モードディスプレイ ミニポート ドライバー (KMD) が、その DxgkDdiQueryAdapterInfo 関数が呼び出されたときに pOutputData が指すバッファーで返す必要がある情報の種類を示します。 入力 が 必要な型 (pInputData) の詳細については、「DXGKARG_QUERYADAPTERINFO」を参照してください。

構文

typedef enum _DXGK_QUERYADAPTERINFOTYPE {
  DXGKQAITYPE_UMDRIVERPRIVATE = 0,
  DXGKQAITYPE_DRIVERCAPS = 1,
  DXGKQAITYPE_QUERYSEGMENT = 2,
  DXGKQAITYPE_RESERVED = 3,
  DXGKQAITYPE_QUERYSEGMENT2 = 4,
  DXGKQAITYPE_QUERYSEGMENT3 = 5,
  DXGKQAITYPE_NUMPOWERCOMPONENTS = 6,
  DXGKQAITYPE_POWERCOMPONENTINFO = 7,
  DXGKQAITYPE_PREFERREDGPUNODE = 8,
  DXGKQAITYPE_POWERCOMPONENTPSTATEINFO = 9,
  DXGKQAITYPE_HISTORYBUFFERPRECISION = 10,
  DXGKQAITYPE_QUERYSEGMENT4 = 11,
  DXGKQAITYPE_SEGMENTMEMORYSTATE = 12,
  DXGKQAITYPE_GPUMMUCAPS = 13,
  DXGKQAITYPE_PAGETABLELEVELDESC = 14,
  DXGKQAITYPE_PHYSICALADAPTERCAPS = 15,
  DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION = 16,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR = 17,
  DXGKQAITYPE_UEFIFRAMEBUFFERRANGES = 18,
  DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES = 19,
  DXGKQAITYPE_DISPLAYID_DESCRIPTOR = 20,
  DXGKQAITYPE_FRAMEBUFFERSAVESIZE = 21,
  DXGKQAITYPE_HARDWARERESERVEDRANGES = 22,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2 = 23,
  DXGKQAITYPE_NODEPERFDATA = 24,
  DXGKQAITYPE_ADAPTERPERFDATA = 25,
  DXGKQAITYPE_ADAPTERPERFDATA_CAPS = 26,
  DXGKQAITYPE_GPUVERSION = 27,
  DXGKQAITYPE_DEVICE_TYPE_CAPS = 28,
  DXGKQAITYPE_WDDMDEVICECAPS = 29,
  DXGKQAITYPE_GPUPCAPS = 30,
  DXGKQAITYPE_QUERYTARGETGAMMACAPS = 31,
  DXGKQAITYPE_SCANOUT_CAPS = 33,
  DXGKQAITYPE_PHYSICAL_MEMORY_CAPS = 34,
  DXGKQAITYPE_IOMMU_CAPS = 35,
  DXGKQAITYPE_HARDWARERESERVEDRANGES2 = 36,
  DXGKQAITYPE_NATIVE_FENCE_CAPS = 37,
  DXGKQAITYPE_USERMODESUBMISSION_CAPS = 38,
  DXGKQAITYPE_DIRTYBITTRACKINGCAPS = 39,
  DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS = 40,
  DXGKQAITYPE_SCATTER_RESERVE = 41,
  DXGKQAITYPE_QUERYPAGINGBUFFERINFO,
  DXGKQAITYPE_QUERYSEGMENTCOUNT,
  DXGKQAITYPE_QUERYSEGMENT5,
  DXGKQAITYPE_QUERYMMUCOUNT,
  DXGKQAITYPE_QUERYMMUS,
  DXGKQAITYPE_64BITONLYCAPS,
  DXGKQAITYPE_PAGINGPROCESSGPUVASIZE
} DXGK_QUERYADAPTERINFOTYPE;

定数

 
DXGKQAITYPE_UMDRIVERPRIVATE
値: 0
ディスプレイ ドライバーのプライベートで独自に定義されたデータ構造を示します。
DXGKQAITYPE_DRIVERCAPS
値: 1
KMD は、ドライバー機能を DXGK_DRIVERCAPS 構造体に設定する必要があります。
DXGKQAITYPE_QUERYSEGMENT
値: 2
KMD は、メモリ セグメント情報を DXGK_QUERYSEGMENTOUT 構造体に設定する必要があります。
DXGKQAITYPE_RESERVED
値: 3
システムで使用するために予約されています。 ドライバーでは を使用しないでください。 この定数は、Windows 7 以降で発生します。
DXGKQAITYPE_QUERYSEGMENT2
値: 4
システムで使用するために予約されています。 ドライバーでは を使用しないでください。 この定数は、Windows 7 以降で発生します。
DXGKQAITYPE_QUERYSEGMENT3
値: 5
KMD は、メモリ セグメント情報を DXGK_QUERYSEGMENTOUT3 構造体に設定する必要があります。 Windows 8 以降でサポートされています。
DXGKQAITYPE_NUMPOWERCOMPONENTS
値: 6
ディスプレイ ミニポートは、使用する電源コンポーネントの数を指定する UINT 値を提供する必要があります。 Windows 8 以降でサポートされています。
DXGKQAITYPE_POWERCOMPONENTINFO
値: 7
KMD は、n番目の電源コンポーネントに関する情報をDXGK_POWER_RUNTIME_COMPONENT構造体に設定する必要があります。n は、DxgkDdiQueryAdapterInfo の呼び出しでDXGKARG_QUERYADAPTERINFO.pInputData によって指定されたコンポーネント インデックスです。 Windows 8 以降でサポートされています。
DXGKQAITYPE_PREFERREDGPUNODE
値: 8
システムで使用するために予約されています。 ドライバーでは を使用しないでください。 この定数は、Windows 8 以降で発生します。
DXGKQAITYPE_POWERCOMPONENTPSTATEINFO
値: 9
システムで使用するために予約されています。 ドライバーでは を使用しないでください。 Windows 8.1 以降でサポートされています。
DXGKQAITYPE_HISTORYBUFFERPRECISION
値: 10
KMD は 、使用する 履歴バッファー データの精度に関する情報をDXGKARG_HISTORYBUFFERPRECISION構造体に設定する必要があります。 Windows 8.1 以降でサポートされています。
DXGKQAITYPE_QUERYSEGMENT4
値: 11
KMD は、メモリ セグメント情報を示すために DXGK_QUERYSEGMENTOUT4 構造体を設定する必要があります。 Windows 10 以降でサポートされています。
DXGKQAITYPE_SEGMENTMEMORYSTATE
値: 12
KMD は、 DXGK_MEMORYRANGE 構造体に不適切なメモリ範囲を設定する必要があります。 Windows 10 以降でサポートされています。
DXGKQAITYPE_GPUMMUCAPS
値: 13
KMD は、仮想メモリ管理機能を DXGK_GPUMMUCAPS 構造体に設定する必要があります。 Windows 10 以降でサポートされています。
DXGKQAITYPE_PAGETABLELEVELDESC
値: 14
システムで使用するために予約されています。 ドライバーでは を使用しないでください。 この定数は、Windows 10 以降で発生します。
DXGKQAITYPE_PHYSICALADAPTERCAPS
値: 15
システムで使用するために予約されています。 ドライバーでは を使用しないでください。 この定数は、Windows 10 以降で発生します。
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION
値: 16
システムで使用するために予約されています。 ドライバーでは を使用しないでください。 この定数は、Windows 10 以降で発生します。
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR
値: 17
Windows 10 バージョン 1703 以降でサポートされています。 クエリへの入力バッファーがDXGK_QUERYINTEGRATEDDISPLAYIN構造体になり、出力バッファーが DXGK_QUERYINTEGRATEDDISPLAYOUT 構造体である統合パネル記述子の 要求を示 します。

この関数はターゲットに対処しますが、この呼び出しでは DxgKrnl アダプター ロックのみが引き継がれ、子デバイス ロックは行われません。 実際には、この呼び出しは子デバイスが公開される前に行われるので、同じターゲットに対応する同時 DDI 呼び出しは行われません。

注: ほとんどの QueryAdapterInfo 呼び出しとは異なり、出力バッファー サイズは可変ですが、ターゲット ID の DXGK_INTEGRATED_DISPLAY_CHILD 構造体の DescriptorLength フィールドから事前にわかっています。出力バッファーのサイズは次のとおりです。
DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ).
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES
値: 18
UEFI フレーム バッファー範囲の要求を示します。 Windows 10 バージョン 1703 以降でサポートされています。
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES
値: 19
Windows 10 バージョン 1703 以降でサポートされています。 外部ディスプレイに対する色測定オーバーライドの要求を示します。クエリへの入力バッファーは、アドレス指定されているターゲット ID のみを含む DXGK_QUERYCOLORIMETRYOVERRIDESIN 構造体であり、出力バッファーは、ドライバーがターゲットにアタッチされているモニターのオーバーライドを書き込む DXGK_COLORIMETRY 構造体です。

この関数はターゲットに対処しますが、この呼び出しでは DxgKrnl アダプター ロックのみが引き継がれ、子デバイス ロックは行われません。 この呼び出しは子デバイスが公開される前に行われるので、同じターゲットに対応する同時 DDI 呼び出しは行われません。

ドライバーに渡されると、出力バッファーはゼロになります。 ドライバーにモニターのオーバーライドがない場合は、STATUS_SUCCESSを返し、出力バッファーをゼロのままにする必要があります。 ドライバーにオーバーライドがある場合は、OS が部分的なオーバーライドを受け入れられないため、モニター機能を説明するために、DXGK_COLORIMETRYのすべてのフィールドに入力します。
DXGKQAITYPE_DISPLAYID_DESCRIPTOR
値: 20
クエリへの入力バッファーがDXGK_QAITARGETIN構造体になり、出力バッファーがDXGK_QUERYINTEGRATEDDISPLAYOUT構造体である統合パネル記述子の要求を示します。 Windows 10 バージョン 1709 以降でサポートされています。
DXGKQAITYPE_FRAMEBUFFERSAVESIZE
値: 21
KMD は、電源切り替え中にシステム メモリに保存するために、フレーム バッファーのサイズを DXGK_FRAMEBUFFERSAVEAREA 構造体に設定する必要があります。 Windows 10 バージョン 1803 以降でサポートされています。
DXGKQAITYPE_HARDWARERESERVEDRANGES
値: 22
KMD は、ハードウェアの予約済みメモリ範囲を DXGK_HARDWARERESERVEDRANGES 構造体に設定する必要があります。 Windows 10 バージョン 1803 以降でサポートされています。
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2
値: 23
Windows 10 バージョン 1803 以降でサポートされています。 クエリへの入力バッファーがDXGK_QAITARGETIN構造体になり、出力バッファーが DXGK_QUERYINTEGRATEDDISPLAYOUT2 構造体である統合パネル記述子の 要求を示 します。 このクエリは、WDDM 2.4 ドライバーの DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR クエリの使用を置き換えます。

TypeIntegratedDisplay 子デバイスは、この値に Type を設定して DxgkDdiQueryAdapterInfo を呼び出すことによって報告されます。
DXGKQAITYPE_NODEPERFDATA
値: 24
KMD は、アダプターからエンジンごとに収集されたパフォーマンス データを間隔ごとに表す DXGK_NODE_PERFDATA 構造体を設定する必要があります。 Windows 10 バージョン 1803 以降でサポートされています。
DXGKQAITYPE_ADAPTERPERFDATA
値: 25
KMD は、アダプターごとに収集されたパフォーマンス データを間隔ごとに表す DXGK_ADAPTER_PERFDATA 構造体を設定する必要があります。 Windows 10 バージョン 1803 以降でサポートされています。
DXGKQAITYPE_ADAPTERPERFDATA_CAPS
値: 26
KMD は、初期化中に GPU ごとに 1 回静的で照会されるデータ機能を表す DXGK_ADAPTER_PERFDATACAPS 構造体を設定する必要があります。 Windows 10 バージョン 1803 以降でサポートされています。
DXGKQAITYPE_GPUVERSION
値: 27
KMD は、GPU の初期化中に BIOS バージョンと GPU アーキテクチャ名を収集するために使用される DXGK_GPUVERSION 構造を 1 回設定する必要があります。 Windows 10 バージョン 1803 以降でサポートされています。
DXGKQAITYPE_DEVICE_TYPE_CAPS
値: 28
KMD は、デバイスの機能の種類を記述する DXGK_DEVICE_TYPE_CAPS 構造体を設定する必要があります。 Windows 10 Version 1809 以降でサポートされています。
DXGKQAITYPE_WDDMDEVICECAPS
値: 29
KMD は、デバイスの初期化中に OS によって照会される WDDM 機能を含む DXGK_WDDMDEVICECAPS 構造体を設定する必要があります。 Windows 10 バージョン 1903 以降でサポートされています。
DXGKQAITYPE_GPUPCAPS
値: 30
KMD は、カーネル モード ディスプレイ ドライバーの GPU 機能を含む DXGK_GPUPCAPS 構造体を設定する必要があります。 Windows 10 バージョン 1903 以降でサポートされています。
DXGKQAITYPE_QUERYTARGETGAMMACAPS
値: 31
KMD には、KMD のガンマ機能を記述する DXGK_TARGET_GAMMA_CAPS 構造体を設定する必要があります。 Windows 10 バージョン 1903 以降でサポートされています。
DXGKQAITYPE_SCANOUT_CAPS
値: 33
KMD は、ドライバーのスキャンアウト機能を記述するDXGK_QUERY_SCANOUT_CAPS_OUT構造体を設定する必要があります。 Windows 10 バージョン 1903 以降でサポートされています。
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS
値: 34
KMD は、デバイスの物理メモリ制限 (最も目に見える物理アドレス) を記述する DXGK_PHYSICAL_MEMORY_CAPS 構造体を設定する必要があります。 Windows Server 2022 (WDDM 2.9) 以降でサポートされています。

IOMMU 線形再マップのドライバーのサポートを示す方法の詳細については、「 DXGKQAITYPE_IOMMU_CAPS 」を参照してください。
DXGKQAITYPE_IOMMU_CAPS
値: 35
KMD は、IOMMU 線形再マップがドライバーによってサポートされていることを示す DXGK_IOMMU_CAPS 構造体を設定する必要があります。 Windows Server 2022 (WDDM 2.9) 以降でサポートされています。 線形再マップのサポートを示すには、ドライバーは、DXGKQAITYPE_PHYSICAL_MEMORY_CAPSキャップを介して、その物理メモリ制限について Dxgkernel に通知する必要もあります。

論理的な再マップは、既存の物理メモリがデバイスによって参照されていない場合にのみ実行できるため、 Dxgkrnl の呼び出しシーケンスは次のようになります。

* ドライバーがリンクされているすべての物理アダプターの情報を収集できるように、すべての物理アダプターに対して DxgkDdiAddDevice を呼び出します。

* DXGKQAITYPE_PHYSICAL_MEMORY_CAPSを使用して DxgkDdiQueryAdapterInfo を呼び出し、DXGKQAITYPE_IOMMU_CAPSして、メモリにアクセスする前にデバイスを作成して IOMMU ドメインにアタッチできるようにします。

* DxgkDdiStartDevice を呼び出してデバイスを起動します。
DXGKQAITYPE_HARDWARERESERVEDRANGES2
値: 36
DXGKQAITYPE_NATIVE_FENCE_CAPS
値: 37
KMD は、ネイティブ GPU フェンスのドライバーのサポートの詳細を含む DXGK_NATIVE_FENCE_CAPS 構造体を設定する必要があります。 Windows 11 バージョン 24H2 以降でサポートされています。 詳細については、「 ネイティブ GPU フェンス」を参照してください。
DXGKQAITYPE_USERMODESUBMISSION_CAPS
値: 38
KMD は、ユーザー モードの作業の送信に関するドライバーのサポートの詳細を含む DXGK_USERMODESUBMISSION_CAPS 構造体を設定する必要があります。 Windows 11 バージョン 24H2 以降でサポートされています。 詳細については、「 ユーザー モードの作業の送信」を参照してください。
DXGKQAITYPE_DIRTYBITTRACKINGCAPS
値: 39
KMD は、ダーティビット追跡のドライバーのサポートの詳細を含むDXGK_DIRTY_BIT_TRACKING_CAPS構造体を設定する必要があります。 Windows 11 バージョン 24H2 以降でサポートされています。 詳細については、「 ダーティ ビット追跡」を参照してください。
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS
値: 40
KMD は、特定のメモリ セグメントでのダーティ ビット追跡のドライバーのサポートの詳細を含むDXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS構造体を設定する必要があります。 Windows 11 バージョン 24H2 以降でサポートされています。 詳細については、「 ダーティ ビット追跡」を参照してください。
DXGKQAITYPE_SCATTER_RESERVE
値: 41
KMD は、ドライバーのスキャッタ予約のサポートの詳細を含む DXGK_QUERYSCATTERRESERVEOUT 構造体を設定する必要があります。 Windows 11 バージョン 24H2 以降でサポートされています。 詳細については、「 GPU-P デバイスでのライブ マイグレーション」を参照してください。

注釈

Dxgkrnl は KMD の DxgkDdiQueryAdapterInfo コールバックを呼び出して、グラフィックス アダプターから構成情報を取得します。 ドライバーは、DXGKARG_QUERYADAPTERINFO構造体の pOutputData メンバーが指すバッファー内の要求された情報を入力します。 入力する構造体の種類については、各列挙値を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista
Header d3dkmddi.h (D3dkmddi.h を含む)

こちらもご覧ください

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo