DXGK_DRIVERCAPS構造体 (d3dkmddi.h)

[アーティクル]
03/08/2023

DXGK_DRIVERCAPS構造体は、ドライバーが DxgkDdiQueryAdapterInfo 関数の呼び出しを通じて提供するディスプレイミニポートドライバーの機能について説明します。

構文

typedef struct _DXGK_DRIVERCAPS {
  [out] PHYSICAL_ADDRESS                   HighestAcceptableAddress;
  [out] UINT                               MaxAllocationListSlotId;
  [out] SIZE_T                             ApertureSegmentCommitLimit;
  [out] UINT                               MaxPointerWidth;
  [out] UINT                               MaxPointerHeight;
  [out] DXGK_POINTERFLAGS                  PointerCaps;
  [out] UINT                               InterruptMessageNumber;
  [out] UINT                               NumberOfSwizzlingRanges;
  [out] UINT                               MaxOverlays;
  union {
    [out] DXGK_GAMMARAMPCAPS      GammaRampCaps;
    [out] DXGK_COLORTRANSFORMCAPS ColorTransformCaps;
  };
  [out] DXGK_PRESENTATIONCAPS              PresentationCaps;
  [out] UINT                               MaxQueuedFlipOnVSync;
  [out] DXGK_FLIPCAPS                      FlipCaps;
  [out] DXGK_VIDSCHCAPS                    SchedulingCaps;
  [out] DXGK_VIDMMCAPS                     MemoryManagementCaps;
  [out] DXGK_GPUENGINETOPOLOGY             GpuEngineTopology;
  [out] DXGK_WDDMVERSION                   WDDMVersion;
        DXGK_VIRTUALADDRESSCAPS_DEPRECATED Reserved;
        DXGK_DMABUFFERCAPS_DEPRECATED      Reserved1;
  [out] D3DKMDT_PREEMPTION_CAPS            PreemptionCaps;
  [out] BOOLEAN                            SupportNonVGA;
  [out] BOOLEAN                            SupportSmoothRotation;
  [out] BOOLEAN                            SupportPerEngineTDR;
  [out] BOOLEAN                            SupportDirectFlip;
  [out] BOOLEAN                            SupportMultiPlaneOverlay;
  [out] BOOLEAN                            SupportRuntimePowerManagement;
  [out] BOOLEAN                            SupportSurpriseRemovalInHibernation;
  [out] BOOLEAN                            HybridDiscrete;
  [out] UINT                               MaxOverlayPlanes;
        BOOLEAN                            HybridIntegrated;
        D3DGPU_VIRTUAL_ADDRESS             InternalGpuVirtualAddressRangeStart;
        D3DGPU_VIRTUAL_ADDRESS             InternalGpuVirtualAddressRangeEnd;
        BOOLEAN                            SupportSurpriseRemoval;
  [out] BOOLEAN                            SupportMultiPlaneOverlayImmediateFlip;
  [out] BOOLEAN                            CursorScaledWithMultiPlaneOverlayPlane0;
        BOOLEAN                            HybridAcpiChainingRequired;
  [out] UINT                               MaxQueuedMultiPlaneOverlayFlipVSync;
  union {
    struct {
      UINT SupportContextlessPresent : 1;
      UINT Detachable : 1;
      UINT VirtualGpuOnly : 1;
      UINT ComputeOnly : 1;
      UINT IndependentVidPnVSyncControl : 1;
      UINT NoHybridDiscreteDListDllSupport : 1;
      UINT DisplayableSupport : 1;
      UINT NoHybridDiscreteDListDllMuxSupport : 1;
      UINT CursorDoesNotSupportXorBlendWithMultiPlaneOverlay : 1;
#if ...
      UINT Reserved : 23;
#elif
      UINT Reserved : 25;
#elif
      UINT Reserved : 26;
#elif
      UINT Reserved : 27;
#elif
      UINT Reserved : 28;
#elif
      UINT Reserved : 29;
#else
      UINT Reserved : 30;
#endif
    };
          UINT Value;
  } MiscCaps;
        UINT                               MaxHwQueuedFlips;
        DXGK_HWQUEUEDFLIP_CAPS             HwQueuedFlipCaps;
} DXGK_DRIVERCAPS;

メンバー

[out] HighestAcceptableAddress

使用するシステムメモリ (RAM) の最大許容物理アドレスを示すPHYSICAL_ADDRESSデータ型 (LARGE_INTEGERとして定義されます)。

[out] MaxAllocationListSlotId

割り当てリストスロット識別子の最大数。割り当てリストスロットは、ダイレクトメモリアクセス (DMA) バッファリングで割り当てが送信される場所を表します。

[out] ApertureSegmentCommitLimit

ディスプレイミニポートドライバーが開口セグメントへのマッピングにサポートする物理メモリの最大バイト数。ビデオメモリマネージャーは、 ApertureSegmentCommitLimit が指定した制限を超える物理メモリを絞りセグメントにマップしません。

[out] MaxPointerWidth

マウスポインターの最大幅 (ピクセル単位)。

[out] MaxPointerHeight

マウスポインターの最大高さ (スキャン行)。

[out] PointerCaps

ドライバーがサポートできるマウスポインター機能をビットフィールドフラグで識別するDXGK_POINTERFLAGS構造体。

[out] InterruptMessageNumber

メッセージシグナル割り込みが使用され、ドライバーが固定メッセージ番号に対応する割り込みハンドラーから DxgkCbNotifyInterrupt 関数を呼び出す場合に使用されるメッセージ番号。

[out] NumberOfSwizzlingRanges

ドライバーがサポートできるスウィズリング範囲の数。

[out] MaxOverlays

ドライバーがサポートできるオーバーレイの最大数。

[out] GammaRampCaps

ドライバーがサポートできるガンマランプ機能をビットフィールドフラグで識別するDXGK_GAMMARAMPCAPS構造体。

[out] ColorTransformCaps

表示パイプラインのガンマ変換機能と色空間変換機能を記述するためのフラグ。注: このフィールドは、この構造体の WDDM 2.2 より前のバージョンの GammaRampCaps を置き換えます。

[out] PresentationCaps

ドライバーがサポートできる表示機能をビットフィールドフラグで識別するDXGK_PRESENTATIONCAPS構造体。

[out] MaxQueuedFlipOnVSync

グラフィックスハードウェアでキューに入れ、保留中にできるフリップの数。グラフィックスハードウェアがフリップをキューに入れているので、各フリップは、VSync割り込みごとにデジタルアナログコンバータ(DAC)にラッチされます。

[out] FlipCaps

ドライバーがサポートできる反転機能をビットフィールドフラグで識別するDXGK_FLIPCAPS構造体。

[out] SchedulingCaps

ドライバーがサポートできるグラフィックス処理装置 (GPU) スケジューリング機能をビットフィールドフラグで識別するDXGK_VIDSCHCAPS構造。

[out] MemoryManagementCaps

ドライバーがサポートできるビデオメモリ管理機能を識別するDXGK_VIDMMCAPS構造。

[out] GpuEngineTopology

ドライバーがサポートできる GPU エンジントポロジを記述するDXGK_GPUENGINETOPOLOGY構造。

[out] WDDMVersion

WDDM のバージョンを識別する DXGK_WDDMVERSION 値。 Windows 7 以降でサポートされています。

ドライバーが Windows 7 以降の機能 (DXGKDDI_INTERFACE_VERSION ≥ DXGKDDI_INTERFACE_VERSION_WIN7) をサポートしている場合、このメンバーは予約されており、ゼロに設定する必要があります。

Windows 7 以降の機能をサポートしていない古いドライバーの場合 (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7)。

Windows 7 WDK (バージョン 7600) でドライバーをコンパイルするには、このメンバーを DXGKDDI_WDDMv1 に設定します。
Windows 8 WDK を使用してドライバーをコンパイルするには、このメンバーを DXGKDDI_WDDMv1_2 に設定します。

Reserved

予約済み。

Reserved1

予約済み。

[out] PreemptionCaps

ドライバーがサポートする GPU グラフィックス要求のプリエンプションの機能を記述する D3DKMDT_PREEMPTION_CAPS 構造体。

Windows 8 以降でサポートされています。

[out] SupportNonVGA

TRUE の場合、ドライバーは、DxgkDdiStopDeviceAndReleasePostDisplayOwnership 関数を使用して、ディスプレイデバイスをリセットし、現在の電源オンセルフテスト (POST) デバイスの所有権を解放することをサポートします。

Windows 8 以降でサポートされています。

[out] SupportSmoothRotation

TRUE の場合、ドライバーは DxgkDdiUpdateActiveVidPnPresentPath 関数を使用してアダプターのパスのローテーションを更新できますが、新しい VidPN の作成と設定は必要ありません。

Windows 8 以降でサポートされています。

[out] SupportPerEngineTDR

TRUE の場合、ドライバーは個々の GPU エンジンのリセットをサポートします。

このメンバーが設定されている場合、ディスプレイミニポートドライバーは 、DxgkDdiQueryDependentEngineGroup、 DxgkDdiQueryEngineStatus、および DxgkDdiResetEngine 関数を実装する必要があります。

Windows 8 以降でサポートされています。

[out] SupportDirectFlip

TRUE の場合、ドライバーは共有マネージドプライマリ割り当ての作成とオープンをサポートします。 TRUE の値は、次のことも示します。

ディスプレイミニポートドライバーでは、 DxgkDdiSetVidPnSourceAddress 関数が呼び出されると、ドライバーはビデオメモリを互換性のない割り当てに反転できないことを保証します。
ユーザーモードドライバーは、デスクトップ Windows マネージャー (DWM) が使用する前に Direct Flip リソースを検証します。

ビデオメモリを Direct Flip リソースに反転できるのは DWM だけです。 DWM は、ユーザーモードの CheckDirectFlipSupport 関数を使用してこれらのリソースを検証します。

Windows 8 以降でサポートされています。

[out] SupportMultiPlaneOverlay

TRUE の場合、ディスプレイミニポートドライバーはマルチプレーンオーバーレイをサポートし、ドライバーは MaxOverlayPlanes メンバーの値も設定する必要があります。 FALSE の場合、DirectX グラフィックスカーネルサブシステムはマルチプレーンオーバーレイ関数を呼び出しません。

Windows 8.1 以降でサポートされます。

[out] SupportRuntimePowerManagement

TRUE の場合、ディスプレイミニポートドライバーは実行時の電源管理をサポートします。

このメンバーが設定されている場合、ディスプレイミニポートドライバーは DxgkDdiSetPowerComponentFState 関数と DxgkDdiPowerRuntimeControlRequest 関数を実装する必要があります。

Windows 8 以降でサポートされています。

[out] SupportSurpriseRemovalInHibernation

TRUE の場合、ディスプレイミニポートドライバーは、休止状態モードの外部ディスプレイデバイスがシステムから切断された後、ソフトウェアリソースのクリーンアップをサポートします。

このメンバーが設定されている場合、ディスプレイミニポートドライバーは、 DxgkDdiNotifySurpriseRemoval 関数を実装する必要があります 。 RemovalType パラメーターを DxgkRemovalHibernation に設定します。

詳細については、「ハイブリッドシステムでのアダプター間リソースの使用」を参照してください。

Windows 8 以降でサポートされています。

[out] HybridDiscrete

TRUE の場合、ディスプレイミニポートドライバーはハイブリッドシステムの個別の GPU です。

このメンバーが設定されている場合、ディスプレイミニポートドライバーは次の操作を行う必要があります。

WDDM 1.3 のサポート
アダプター間リソースのサポート
表示出力がない

詳細については、「ハイブリッドシステムでのアダプター間リソースの使用」を参照してください。

Windows 8.1 以降でサポートされます。

[out] MaxOverlayPlanes

SupportRuntimePowerManagement が TRUE の場合、ディスプレイミニポートドライバーは MaxOverlayPlanes を、サポートできる 1 つの出力 (プライマリサーフェスを含む) で同時に表示できるオーバーレイプレーンの最大数に設定する必要があります。使用可能なプレーンの数が操作モードの変更時に変更される場合、ドライバーは最適なシナリオを反映する数値を使用する必要があります。

Windows 8.1 以降でサポートされます。

HybridIntegrated

現在の GPU がハイブリッドであるかどうかを示します。

InternalGpuVirtualAddressRangeStart

内部 GPU 仮想アドレス範囲が開始します。

InternalGpuVirtualAddressRangeEnd

内部 GPU 仮想アドレス範囲の終了。

SupportSurpriseRemoval

TRUE の場合、ディスプレイミニポートドライバーは、突然の削除をサポートします。

[out] SupportMultiPlaneOverlayImmediateFlip

TRUE の場合、表示ミニポートドライバーは、変更する値が表示される物理アドレスである限り、マルチプレーンオーバーレイプレーンへの即時反転をサポートします。

[out] CursorScaledWithMultiPlaneOverlayPlane0

TRUE の場合、ディスプレイハードウェアは、平面ごとにマルチプレーンオーバーレイストレッチが適用されている場合、平面 0 に適用されるのと同じ拡大縮小率をハードウェアカーソルに常に適用します。

HybridAcpiChainingRequired

このハイブリッドディスクリートドライバーには、統合アダプターでトリガーされる ACPI イベントのチェーンが必要であることを示します。

[out] MaxQueuedMultiPlaneOverlayFlipVSync

1 つのプレーンに対する更新の最大数を 1 つの Vsync 期間内に作成できることを示します。この場合、最新の更新プログラムは以前の更新プログラムをオーバーライドします。ドライバーがハードウェアフリップキューをサポートしている場合、OS はこの値を無視します。

MiscCaps

その他の機能。

MiscCaps.SupportContextlessPresent

DDI 呼び出しで null コンテキストをサポートします。この値を設定すると、OS は現在の関連 DDI で NULL コンテキストを渡します。 WDDM 2.4 以降でサポートされています。

MiscCaps.Detachable

取り外し可能、つまりホットプラグ可能。アダプターがホットプラグ可能な場合、ドライバーはアダプターの初期化中にこのビットを設定します。 WDDM 2.4 以降でサポートされています。

MiscCaps.VirtualGpuOnly

アダプターは、ホスト上の Direct3D アプリケーションで使用しないでください。 WDDM 2.5 以降でサポートされています。

MiscCaps.ComputeOnly

WDDM のレンダリング専用デバイス機能をレンダリングすることで、Compute-Only デバイスをサポートします。 Windows 10 バージョン 1901 (WDDM 2.6) 以降でサポートされます

MiscCaps.IndependentVidPnVSyncControl

この機能を設定するドライバーは、DdiControlInterrupt3 で指定された VidPnSourceId を読み取り、前述の VidPnSourceId で VSync を制御する必要があります。 Windows 10 バージョン 2004 (WDDM 2.7) 以降でサポートされています。

MiscCaps.NoHybridDiscreteDListDllSupport

ドライバーが d-List をサポートしているかどうかを示します。 Windows 10 バージョン 2004 (WDDM 2.8) 以降でサポートされています。

MiscCaps.DisplayableSupport

ドライバーが表示可能な機能をサポートしているかどうかを示します。 Windows 11 (WDDM 3.0) 以降でサポートされます。

MiscCaps.NoHybridDiscreteDListDllMuxSupport

MiscCaps.CursorDoesNotSupportXorBlendWithMultiPlaneOverlay

MiscCaps.Reserved

予約済み。

MiscCaps.Value

MiscCaps ビットにアクセスする別の方法。

MaxHwQueuedFlips

ドライバーがサポートするハードウェアフリップキューの最大数。 OS でハードウェアフリップキューのサポートが許可されている場合、ドライバーは MaxHwQueuedFlips を 1 より大きい値に設定できます。 Windows Server 2022 (WDDM 2.9) で追加されました。Windows 11 (WDDM 3.0) 以降でサポートされています。

HwQueuedFlipCaps

ハードウェアフリップキューの機能を説明する DXGK_HWQUEUEDFLIP_CAPS 値。 Windows Server 2022 (WDDM 2.9) で追加されました。Windows 11 (WDDM 3.0) 以降でサポートされています。