DXGK_QUERYADAPTERINFOTYPE列挙 (d3dkmddi.h)
DXGK_QUERYADAPTERINFOTYPE 列挙は、DxgkDdiQueryAdapterInfo 関数が呼び出されたときに pOutputData が指すバッファー内でカーネル モード ディスプレイ ミニポート ドライバー (KMD) が返す必要がある情報の種類を示します。 入力が必要な型 (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 = 42,
DXGKQAITYPE_QUERYSEGMENTCOUNT = 43,
DXGKQAITYPE_QUERYSEGMENT5 = 44,
DXGKQAITYPE_QUERYMMUCOUNT = 45,
DXGKQAITYPE_QUERYMMUS = 46,
DXGKQAITYPE_64BITONLYCAPS = 47,
DXGKQAITYPE_PAGINGPROCESSGPUVASIZE = 48
} 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 構造を設定する必要があります。 Windows 10 バージョン 1803 以降でサポートされています。 |
DXGKQAITYPE_DEVICE_TYPE_CAPS値: 28 KMD は、デバイスの機能の種類を記述する DXGK_DEVICE_TYPE_CAPS 構造体を設定する必要があります。 Windows 10 バージョン 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 を呼び出して、ドライバーがリンクされているすべての物理アダプターの情報を収集できるようにします。 * DxgkDdiQueryAdapterInfo DXGKQAITYPE_PHYSICAL_MEMORY_CAPSと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 デバイスでのライブ マイグレーション」を参照してください。 |
DXGKQAITYPE_QUERYPAGINGBUFFERINFO値: 42 |
DXGKQAITYPE_QUERYSEGMENTCOUNT値: 43 |
DXGKQAITYPE_QUERYSEGMENT5値: 44 |
DXGKQAITYPE_QUERYMMUCOUNT値: 45 |
DXGKQAITYPE_QUERYMMUS値: 46 |
DXGKQAITYPE_64BITONLYCAPS値: 47 |
DXGKQAITYPE_PAGINGPROCESSGPUVASIZE値: 48 KMD は、ページング プロセスの GPU VA 領域のサイズをメガバイト単位で返す必要があります。 詳細については、「割り当て通知」を参照してください。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。 |
備考
Dxgkrnl 、KMD の DxgkDdiQueryAdapterInfo コールバックを呼び出して、グラフィックス アダプターから構成情報を取得します。 ドライバーは、DXGKARG_QUERYADAPTERINFO 構造体の pOutputData メンバーが指すバッファー内の要求された情報を入力します。 入力する構造体の種類については、各列挙値を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| ヘッダー | d3dkmddi.h (D3dkmddi.h を含む) |
関連項目
DxgkDdiQueryAdapterInfoの